Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Windows.Devices.WiFiDirect
WiFiDirectAdvertisement
InformationElements
IsAutonomousGroupOwnerEnabled
LegacySettings
ListenStateDiscoverability
SupportedConfigurationMethods
WiFiDirectAdvertisementListenStateDiscoverability
WiFiDirectAdvertisementPublisher
Advertisement
Start
Status
StatusChanged
Stop
WiFiDirectAdvertisementPublisher
WiFiDirectAdvertisementPublisherStatus
WiFiDirectAdvertisementPublisherStatusChangedEventArgs
Error
Status
WiFiDirectConfigurationMethod
WiFiDirectConnectionListener
ConnectionRequested
WiFiDirectConnectionListener
WiFiDirectConnectionParameters
GetDevicePairingKinds
GroupOwnerIntent
PreferenceOrderedConfigurationMethods
PreferredPairingProcedure
WiFiDirectConnectionParameters
WiFiDirectConnectionRequest
Close
DeviceInformation
Dispose
WiFiDirectConnectionRequestedEventArgs
GetConnectionRequest
WiFiDirectConnectionStatus
WiFiDirectDevice
Close
ConnectionStatus
ConnectionStatusChanged
DeviceId
Dispose
FromIdAsync
GetConnectionEndpointPairs
GetDeviceSelector
WiFiDirectDeviceSelectorType
WiFiDirectError
WiFiDirectInformationElement
CreateFromBuffer
CreateFromDeviceInformation
Oui
OuiType
Value
WiFiDirectInformationElement
WiFiDirectLegacySettings
IsEnabled
Passphrase
Ssid
WiFiDirectPairingProcedure
Windows.Devices.WiFiDirect Windows.Devices.WiFiDirect
Windows.Devices.WiFiDirect Namespace
Contains classes that support connecting to associated Wi-Fi Direct devices and associated endpoints for PCs, tablets,
and phones.
Introduction
You can use the WiFiDirectDevice class to establish a socket connection with other devices that have a Wi-Fi Direct
(WFD ) capable device. You can call the GetDeviceSelector method to get the device identifier for a Wi-Fi Direct device.
Once you have a reference to a WiFiDirectDevice on your computer, you can call the GetConnectionEndpointPairs
method to get an EndpointPair object and establish a socket connection using classes in the
Windows.Networking.Sockets namespace.
You can add a handler for the ConnectionStatusChanged event to be notified when the connection has been
established or disconnected.
Only one app can be connected to a Wi-Fi Direct device at a time.
You must enable the Proximity capability to communicate with Wi-Fi Direct devices.
Classes
WiFiDirectAdvertisement
WiFiDirectAdvertisement Represent a Wi-Fi Direct advertisement and allows the app to
control the listen state and custom information elements in
WiFiDirectAdvertisement
the advertisement.
WiFiDirectAdvertisementPublisher
WiFiDirectAdvertisementPublisher An object to publish Wi-Fi Direct advertisements.
WiFiDirectAdvertisementPublisher
WiFiDirectAdvertisementPublisherStatusChangedEventArgs
Provides data for a StatusChanged event on a
WiFiDirectAdvertisementPublisherStatusChangedEventArgs
WiFiDirectAdvertisementPublisher.
WiFiDirectAdvertisementPublisherStatusChangedEventArgs
WiFiDirectConnectionListener
WiFiDirectConnectionListener Class used to listen for incoming Wi-Fi Direct connection
requests.
WiFiDirectConnectionListener
WiFiDirectConnectionParameters
WiFiDirectConnectionParameters Used by an app to specify the connection parameters for a
Wi-Fi Direct connect/pairing operation.
WiFiDirectConnectionParameters
WiFiDirectConnectionRequest
WiFiDirectConnectionRequest A Wi-FI Direct connection request received by a
WiFiDirectConnectionListener.
WiFiDirectConnectionRequest
WiFiDirectConnectionRequestedEventArgs
WiFiDirectConnectionRequestedEventArgs Provides data for a ConnectionRequested event on a
WiFiDirectConnectionListener.
WiFiDirectConnectionRequestedEventArgs
WiFiDirectDevice WiFiDirectDevice
WiFiDirectDevice Manages connections to associated Wi-Fi Direct devices.
WiFiDirectInformationElement
WiFiDirectInformationElement Represents information elements in a Wi-Fi Direct packet.
WiFiDirectInformationElement
WiFiDirectLegacySettings
WiFiDirectLegacySettings Settings governing "legacy" mode (non-Wi-Fi Direct
connections to the access point being advertised.)
WiFiDirectLegacySettings
This access point allows devices that do not support Wi-Fi
Direct to connect to a device that does support it, and to use
the services offered by the Wi-Fi Direct device. The connection
does not serve as a general-purpose Wi-Fi access point.
Enums
WiFiDirectAdvertisementListenStateDiscoverability
WiFiDirectAdvertisementListenStateDiscoverability Specifies whether the Wi-Fi Direct device is listening and
discoverable.
WiFiDirectAdvertisementListenStateDiscoverability
WiFiDirectAdvertisementPublisherStatus
WiFiDirectAdvertisementPublisherStatus Represents the possible states of the
WiFiDirectAdvertisementPublisher.
WiFiDirectAdvertisementPublisherStatus
WiFiDirectConfigurationMethod
WiFiDirectConfigurationMethod Specifies a Wi-Fi Direct configuration method. Configuration is
how a user tells one piece of Wi-Fi Direct equipment to
WiFiDirectConfigurationMethod
connect to another piece of Wi-Fi Direct equipment.
WiFiDirectConnectionStatus
WiFiDirectConnectionStatus Describes the connection status of a WiFiDirectDevice object.
WiFiDirectConnectionStatus
WiFiDirectDeviceSelectorType
WiFiDirectDeviceSelectorType Specifies the device selector type for Wi-Fi Direct.
WiFiDirectDeviceSelectorType
WiFiDirectError WiFiDirectError
WiFiDirectError Specifies some common Wi-Fi Direct error cases.
WiFiDirectPairingProcedure
WiFiDirectPairingProcedure Specifies a direct pairing procedure.
WiFiDirectPairingProcedure Wi-Fi Direct supports two different pairing procedures. In the
Group Owner Negotiation procedure, the connecting device
chooses the configuration method (PIN entry, PIN display, or
pushbutton pairing.) In the P2P Invitation procdure, the
accepting device chooses the configuration method. Use the
values in this enumeration to identify a pairing procedure.
WiFiDirectAdvertisement WiFiDirectAdvertisement WiFi
DirectAdvertisement Class
Represent a Wi-Fi Direct advertisement and allows the app to control the listen state and custom information elements
in the advertisement.
D eclaration
public : sealed class WiFiDirectAdvertisement : IWiFiDirectAdvertisement,
IWiFiDirectAdvertisement2
struct winrt::Windows::Devices::WiFiDirect::WiFiDirectAdvertisement : IWiFiDirectAdvertisement,
IWiFiDirectAdvertisement2
public sealed class WiFiDirectAdvertisement : IWiFiDirectAdvertisement,
IWiFiDirectAdvertisement2
I nheritance H ierarchy
None
Properties
InformationElements
InformationElements
InformationElements
IsAutonomousGroupOwnerEnabled
IsAutonomousGroupOwnerEnabled
IsAutonomousGroupOwnerEnabled
LegacySettings
LegacySettings
LegacySettings
ListenStateDiscoverability
ListenStateDiscoverability
ListenStateDiscoverability
Gets or sets the listen state and whether the Wi-Fi Direct device is discoverable.
SupportedConfigurationMethods
SupportedConfigurationMethods
SupportedConfigurationMethods
Gets a device's supported configuration methods.
When two devices are attempting to connect, their preferred pairing procedures and supported configuration
methods are used to determine how pairing is accomplished.
WiFiDirectAdvertisement.InformationElements WiFiDirect
Advertisement.InformationElements WiFiDirect
Advertisement.InformationElements
I n this Article
Edit
Information elements to advertise in the Wi-Fi Direct advertisement.
public : IVector<WiFiDirectInformationElement> InformationElements { get; set; }
IVector<WiFiDirectInformationElement> InformationElements();
Returns
IList<WiFiDirectInformationElement>
Information elements to advertise.
Remarks
The default value for this property is NULL.
WiFiDirectAdvertisement.IsAutonomousGroupOwner
Enabled WiFiDirectAdvertisement.IsAutonomousGroup
OwnerEnabled WiFiDirectAdvertisement.IsAutonomous
GroupOwnerEnabled
I n this Article
Edit
Whether autonomous group owner will be enabled.
public : Platform::Boolean IsAutonomousGroupOwnerEnabled { get; set; }
bool IsAutonomousGroupOwnerEnabled();
Returns
bool
Whether autonomous group owner will be enabled.
Remarks
The default value for this property is FALSE.
WiFiDirectAdvertisement.LegacySettings WiFiDirect
Advertisement.LegacySettings WiFiDirectAdvertisement.
LegacySettings
I n this Article
Edit
Gets the settings object for "legacy" (non-Wi-Fi Direct) connections.
public : WiFiDirectLegacySettings LegacySettings { get; }
WiFiDirectLegacySettings LegacySettings();
public WiFiDirectLegacySettings LegacySettings { get; }
Returns
WiFiDirectLegacySettings
The legacy settings object.
WiFiDirectAdvertisement.ListenStateDiscoverability WiFi
DirectAdvertisement.ListenStateDiscoverability WiFi
DirectAdvertisement.ListenStateDiscoverability
I n this Article
Edit
Gets or sets the listen state and whether the Wi-Fi Direct device is discoverable.
public : WiFiDirectAdvertisementListenStateDiscoverability ListenStateDiscoverability { get; set; }
WiFiDirectAdvertisementListenStateDiscoverability ListenStateDiscoverability();
void ListenStateDiscoverability(WiFiDirectAdvertisementListenStateDiscoverability
listenstatediscoverability);
public WiFiDirectAdvertisementListenStateDiscoverability ListenStateDiscoverability { get; set; }
Returns
WiFiDirectAdvertisementListenStateDiscoverability
The listen state and whether the Wi-Fi Direct device is discoverable.
Remarks
The default value for this property is None (not discoverable).
See WiFiDirectAdvertisementListenStateDiscoverability
Also
WiFiDirectAdvertisement.SupportedConfiguration
Methods WiFiDirectAdvertisement.Supported
ConfigurationMethods WiFiDirectAdvertisement.
SupportedConfigurationMethods
I n this Article
Edit
Gets a device's supported configuration methods.
When two devices are attempting to connect, their preferred pairing procedures and supported configuration methods
are used to determine how pairing is accomplished.
public : IVector<WiFiDirectConfigurationMethod> SupportedConfigurationMethods { get; }
IVector<WiFiDirectConfigurationMethod> SupportedConfigurationMethods();
public IList<WiFiDirectConfigurationMethod> SupportedConfigurationMethods { get; }
Returns
IList<WiFiDirectConfigurationMethod>
A list of WiFiDirectConfigurationMethod values representing supported configuration methods.
Additional features and requirements
Device family Windows 10 (introduced v10.0.10586.0 - for Xbox, see UWP
features that aren't yet supported on Xbox)
D eclaration
public : enum class WiFiDirectAdvertisementListenStateDiscoverability
enum class
winrt::Windows::Devices::WiFiDirect::WiFiDirectAdvertisementListenStateDiscoverability : int32_t
public enum WiFiDirectAdvertisementListenStateDiscoverability
I nheritance H ierarchy
None
Fields
Intensive Intensive Intensive The device is discoverable when the app is in the foreground or in the background.
Normal Normal Normal The device is highly discoverable so long as the app is in the foreground.
WiFiDirectAdvertisementPublisher WiFiDirect
AdvertisementPublisher WiFiDirectAdvertisement
Publisher Class
An object to publish Wi-Fi Direct advertisements.
D eclaration
public : sealed class WiFiDirectAdvertisementPublisher : IWiFiDirectAdvertisementPublisher
struct winrt::Windows::Devices::WiFiDirect::WiFiDirectAdvertisementPublisher :
IWiFiDirectAdvertisementPublisher
public sealed class WiFiDirectAdvertisementPublisher : IWiFiDirectAdvertisementPublisher
I nheritance H ierarchy
None
Remarks
Windows 10, version 1607, supports Mobile Hotspot, an enhanced version of the mobile broadband tethering feature.
If Mobile Hotspot is running, the functionality of this class is not supported. It is likely to stop working.
The Mobile Hotspot and Wi-Fi Direct technology cannot run at the same time. Mobile Hotspot takes precedence over
all Wi-Fi Direct scenarios.
Constructors
WiFiDirectAdvertisementPublisher()
WiFiDirectAdvertisementPublisher()
WiFiDirectAdvertisementPublisher()
Properties
Advertisement
Advertisement
Advertisement
Status
Status
Status
Methods
Start()
Start()
Start()
Stop()
Stop()
Stop()
Events
StatusChanged
StatusChanged
StatusChanged
Returns
WiFiDirectAdvertisement
The Wi-Fi Direct advertisement to publish.
See WiFiDirectAdvertisement
Also
WiFiDirectAdvertisementPublisher.Start WiFiDirect
AdvertisementPublisher.Start WiFiDirectAdvertisement
Publisher.Start
I n this Article
Edit
Starts the Wi-Fi Direct advertisement.
public : void Start()
void Start() const;
public void Start()
Remarks
The status of the WiFiDirectAdvertisementPublisher will transition to the Started state or to the Aborted state if the
request failed immediately due to an error.
The WiFiDirectAdvertisementPublisher will be automatically stopped when an app is suspended if the
ListenStateDiscoverability property on the WiFiDirectAdvertisement is set to Normal.
See WiFiDirectAdvertisement
Also WiFiDirectAdvertisementPublisherStatus
WiFiDirectAdvertisementPublisher.Status WiFiDirect
AdvertisementPublisher.Status WiFiDirectAdvertisement
Publisher.Status
I n this Article
Edit
Gets the current status of the WiFiDirectAdvertisementPublisher.
public : WiFiDirectAdvertisementPublisherStatus Status { get; }
WiFiDirectAdvertisementPublisherStatus Status();
public WiFiDirectAdvertisementPublisherStatus Status { get; }
Returns
WiFiDirectAdvertisementPublisherStatus
The current status of the WiFiDirectAdvertisementPublisher.
See WiFiDirectAdvertisementPublisherStatus
Also
WiFiDirectAdvertisementPublisher.StatusChanged WiFi
DirectAdvertisementPublisher.StatusChanged WiFiDirect
AdvertisementPublisher.StatusChanged
I n this Article
Edit
Notification that the status of the WiFiDirectAdvertisementPublisher has changed.
public : event TypedEventHandler<WiFiDirectAdvertisementPublisher,
WiFiDirectAdvertisementPublisherStatusChangedEventArgs> StatusChanged
// Register
event_token StatusChanged(TypedEventHandler<WiFiDirectAdvertisementPublisher,
WiFiDirectAdvertisementPublisherStatusChangedEventArgs> const& handler) const;
See WiFiDirectAdvertisementPublisherStatus
Also
WiFiDirectAdvertisementPublisher.Stop WiFiDirect
AdvertisementPublisher.Stop WiFiDirectAdvertisement
Publisher.Stop
I n this Article
Edit
Stops the Wi-Fi Direct advertisement.
public : void Stop()
void Stop() const;
public void Stop()
Remarks
Calling the Stop method in the Stopped or Aborted state has no effect.
See WiFiDirectAdvertisementPublisherStatus
Also
WiFiDirectAdvertisementPublisher WiFiDirect
AdvertisementPublisher WiFiDirectAdvertisement
Publisher
I n this Article
Edit
Creates a new WiFiDirectAdvertisementPublisher object.
public : WiFiDirectAdvertisementPublisher()
WiFiDirectAdvertisementPublisher() const;
public WiFiDirectAdvertisementPublisher()
WiFiDirectAdvertisementPublisherStatus WiFiDirect
AdvertisementPublisherStatus WiFiDirectAdvertisement
PublisherStatus Enum
Represents the possible states of the WiFiDirectAdvertisementPublisher.
D eclaration
public : enum class WiFiDirectAdvertisementPublisherStatus
enum class winrt::Windows::Devices::WiFiDirect::WiFiDirectAdvertisementPublisherStatus : int32_t
public enum WiFiDirectAdvertisementPublisherStatus
I nheritance H ierarchy
None
Fields
Aborted Aborted Aborted The publisher is aborted due to error.
Started Started Started The publisher is started and advertisements are being published.
D eclaration
public : sealed class WiFiDirectAdvertisementPublisherStatusChangedEventArgs :
IWiFiDirectAdvertisementPublisherStatusChangedEventArgs
struct
winrt::Windows::Devices::WiFiDirect::WiFiDirectAdvertisementPublisherStatusChangedEventArgs :
IWiFiDirectAdvertisementPublisherStatusChangedEventArgs
public sealed class WiFiDirectAdvertisementPublisherStatusChangedEventArgs :
IWiFiDirectAdvertisementPublisherStatusChangedEventArgs
I nheritance H ierarchy
None
Remarks
A WiFiDirectAdvertisementPublisherStatusChangedEventArgs instance is created when the StatusChanged event
occurs on a WiFiDirectAdvertisementPublisher object.
Properties
Error
Error
Error
Status
Status
Status
Returns
WiFiDirectError
The error status for a StatusChanged event on a WiFiDirectAdvertisementPublisher.
WiFiDirectAdvertisementPublisherStatusChangedEvent
Args.Status WiFiDirectAdvertisementPublisherStatus
ChangedEventArgs.Status WiFiDirectAdvertisement
PublisherStatusChangedEventArgs.Status
I n this Article
Edit
Gets the new status of the WiFiDirectAdvertisementPublisher.
public : WiFiDirectAdvertisementPublisherStatus Status { get; }
WiFiDirectAdvertisementPublisherStatus Status();
public WiFiDirectAdvertisementPublisherStatus Status { get; }
Returns
WiFiDirectAdvertisementPublisherStatus
The new status of the WiFiDirectAdvertisementPublisher.
Remarks
The current status of the WiFiDirectAdvertisementPublisher might have changed by the time this property is accessed.
This property reflects the new status of the WiFiDirectAdvertisementPublisher at the time it was changed and the
StatusChanged event occurred.
See WiFiDirectAdvertisementPublisherStatus
Also
WiFiDirectConfigurationMethod WiFiDirectConfiguration
Method WiFiDirectConfigurationMethod Enum
Specifies a Wi-Fi Direct configuration method. Configuration is how a user tells one piece of Wi-Fi Direct equipment to
connect to another piece of Wi-Fi Direct equipment.
D eclaration
public : enum class WiFiDirectConfigurationMethod
enum class winrt::Windows::Devices::WiFiDirect::WiFiDirectConfigurationMethod : int32_t
public enum WiFiDirectConfigurationMethod
I nheritance H ierarchy
None
Fields
DisplayPin This device accepts connections from devices that provide the PIN this device currently displays.
DisplayPin
DisplayPin
ProvidePin This device accepts entry of the PIN being displayed on the accepting device.
ProvidePin
ProvidePin
PushButton This device uses the pushbutton method for pairing. A user pushes a button on both the connecting
PushButton device and the accepting device in order to establish a connection between them.
PushButton
WiFiDirectConnectionListener WiFiDirectConnection
Listener WiFiDirectConnectionListener Class
Class used to listen for incoming Wi-Fi Direct connection requests.
D eclaration
public : sealed class WiFiDirectConnectionListener : IWiFiDirectConnectionListener
struct winrt::Windows::Devices::WiFiDirect::WiFiDirectConnectionListener :
IWiFiDirectConnectionListener
public sealed class WiFiDirectConnectionListener : IWiFiDirectConnectionListener
I nheritance H ierarchy
None
Remarks
If multiple apps are listening for ConnectionRequested event notifications, the notifications will be sent to the apps
sequentially in last in first out order of when the apps registered the event handler.
This class is similar to the StreamSocketListener class in the Windows.Networking.Sockets namespace. When it sees
an incoming request of the appropriate kind, it raises a ConnectionRequested event.
Constructors
WiFiDirectConnectionListener()
WiFiDirectConnectionListener()
WiFiDirectConnectionListener()
Events
ConnectionRequested
ConnectionRequested
ConnectionRequested
D eclaration
public : sealed class WiFiDirectConnectionParameters : IDevicePairingSettings,
IWiFiDirectConnectionParameters, IWiFiDirectConnectionParameters2
struct winrt::Windows::Devices::WiFiDirect::WiFiDirectConnectionParameters :
IDevicePairingSettings, IWiFiDirectConnectionParameters, IWiFiDirectConnectionParameters2
public sealed class WiFiDirectConnectionParameters : IDevicePairingSettings,
IWiFiDirectConnectionParameters, IWiFiDirectConnectionParameters2
I nheritance H ierarchy
None
Constructors
WiFiDirectConnectionParameters()
WiFiDirectConnectionParameters()
WiFiDirectConnectionParameters()
Properties
GroupOwnerIntent
GroupOwnerIntent
GroupOwnerIntent
The group owner intent value used for group owner negotiation in a Wi-Fi Direct connect/pairing operation.
PreferenceOrderedConfigurationMethods
PreferenceOrderedConfigurationMethods
PreferenceOrderedConfigurationMethods
PreferredPairingProcedure
PreferredPairingProcedure
PreferredPairingProcedure
Methods
GetDevicePairingKinds(WiFiDirectConfigurationMethod)
GetDevicePairingKinds(WiFiDirectConfigurationMethod)
GetDevicePairingKinds(WiFiDirectConfigurationMethod)
Parameters
configurationMethod WiFiDirectConfigurationMethod
A value specifying a configuration method.
Returns
DevicePairingKinds
A value specifying a pairing kind, for use with the pairing functionality in the Windows.Devices.Enumeration API.
Additional features and requirements
Device family Windows 10 (introduced v10.0.10586.0 - for Xbox, see UWP
features that aren't yet supported on Xbox)
Returns
short
The group owner intent value used for group owner negotiation in a Wi-Fi Direct connect/pairing operation.
Remarks
The default value for this property is 14. So the WiFiDirectConnectionListener will try hard to be the group owner
without forcing the issue.
WiFiDirectConnectionParameters.PreferenceOrdered
ConfigurationMethods WiFiDirectConnectionParameters.
PreferenceOrderedConfigurationMethods WiFiDirect
ConnectionParameters.PreferenceOrderedConfiguration
Methods
I n this Article
Edit
Gets a list of supported configuration methods, in order of preference.
public : IVector<WiFiDirectConfigurationMethod> PreferenceOrderedConfigurationMethods { get; }
IVector<WiFiDirectConfigurationMethod> PreferenceOrderedConfigurationMethods();
public IList<WiFiDirectConfigurationMethod> PreferenceOrderedConfigurationMethods { get; }
Returns
IList<WiFiDirectConfigurationMethod>
A list of WiFiDirectConfigurationMethod values representing supported configuration methods, in order of preference
(most preferred first.)
Returns
WiFiDirectPairingProcedure
The preferred pairing procedure.
Additional features and requirements
Device family Windows 10 (introduced v10.0.10586.0 - for Xbox, see UWP
features that aren't yet supported on Xbox)
D eclaration
public : sealed class WiFiDirectConnectionRequest : IWiFiDirectConnectionRequest, IClosable
struct winrt::Windows::Devices::WiFiDirect::WiFiDirectConnectionRequest :
IWiFiDirectConnectionRequest, IClosable
public sealed class WiFiDirectConnectionRequest : IWiFiDirectConnectionRequest, IDisposable
I nheritance H ierarchy
None
Remarks
A WiFiDirectConnectionRequest instance is retrieved by the GetConnectionRequest method on the
WiFiDirectConnectionRequestedEventArgs object when the ConnectionRequested event occurs on a
WiFiDirectConnectionListener.
Retrieve information about the requesting device using DeviceInformation.
The Close method releases all unmanaged resources associated with the WiFiDirectConnectionRequest object.
Properties
DeviceInformation
DeviceInformation
DeviceInformation
Gets device information for the endpoint making the Wi-Fi Direct connection request.
Methods
Close()
Close()
Close()
Dispose()
Dispose()
Dispose()
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
WiFiDirectConnectionRequest.Close WiFiDirect
ConnectionRequest.Close WiFiDirectConnectionRequest.
Close
I n this Article
Edit
Closes the WiFiDirectConnectionRequest object.
public : void Close()
void Close() const;
// This member is not implemented in C#
WiFiDirectConnectionRequest.DeviceInformation WiFi
DirectConnectionRequest.DeviceInformation WiFiDirect
ConnectionRequest.DeviceInformation
I n this Article
Edit
Gets device information for the endpoint making the Wi-Fi Direct connection request.
public : DeviceInformation DeviceInformation { get; }
DeviceInformation DeviceInformation();
public DeviceInformation DeviceInformation { get; }
Returns
DeviceInformation
Device information for the endpoint making the Wi-Fi Direct connection request.
IDisposable.Dispose IDisposable.Dispose
I n this Article
Edit
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
D eclaration
public : sealed class WiFiDirectConnectionRequestedEventArgs :
IWiFiDirectConnectionRequestedEventArgs
struct winrt::Windows::Devices::WiFiDirect::WiFiDirectConnectionRequestedEventArgs :
IWiFiDirectConnectionRequestedEventArgs
public sealed class WiFiDirectConnectionRequestedEventArgs :
IWiFiDirectConnectionRequestedEventArgs
I nheritance H ierarchy
None
Remarks
Your code doesn't instantiate this class. Instead, a WiFiDirectConnectionRequestedEventArgs instance is created when
the when the ConnectionRequested event occurs on a WiFiDirectConnectionListener.
Not all WiFiDirectDevice properties are exposed on ConnectionRequested event by a WiFiDirectConnectionListener.
Properties that are exposed include the following:
Device Friendly Name
Device Category
Model ID
Information elements
Methods
GetConnectionRequest()
GetConnectionRequest()
GetConnectionRequest()
Returns
WiFiDirectConnectionRequest
The Wi-FI Direct connection request.
See WiFiDirectConnectionRequest
Also
WiFiDirectConnectionStatus WiFiDirectConnectionStatus
WiFiDirectConnectionStatus Enum
Describes the connection status of a WiFiDirectDevice object.
D eclaration
public : enum class WiFiDirectConnectionStatus
enum class winrt::Windows::Devices::WiFiDirect::WiFiDirectConnectionStatus : int32_t
public enum WiFiDirectConnectionStatus
I nheritance H ierarchy
None
Fields
Connected Connected Connected The device is connected to an associated Wi-Fi Direct device.
See Also
WiFiDirectDevice WiFiDirectDevice WiFiDirectDevice
Class
Manages connections to associated Wi-Fi Direct devices.
D eclaration
public : sealed class WiFiDirectDevice : IWiFiDirectDevice, IClosable
struct winrt::Windows::Devices::WiFiDirect::WiFiDirectDevice : IWiFiDirectDevice, IClosable
public sealed class WiFiDirectDevice : IWiFiDirectDevice, IDisposable
I nheritance H ierarchy
None
Remarks
You can use the WiFiDirectDevice class to establish a socket connection with other devices that have a Wi-Fi Direct
(WFD ) capable device. You can call the GetDeviceSelector method to get the device identifier for a Wi-Fi Direct device.
Once you have a reference to a WiFiDirectDevice on your computer, you can call the GetConnectionEndpointPairs
method to get an EndpointPair object and establish a socket connection using the Windows.Networking.Sockets API.
You can add a handler for the ConnectionStatusChanged event to be notified when the connection has been
established or disconnected.
Only one app can be connected to a Wi-Fi Direct device at a time.
You must enable the Proximity capability to communicate with Wi-Fi Direct devices.
Properties
ConnectionStatus
ConnectionStatus
ConnectionStatus
DeviceId
DeviceId
DeviceId
Methods
Close()
Close()
Close()
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
FromIdAsync(String)
FromIdAsync(String)
FromIdAsync(String)
Creates an instance of the WiFiDirectDevice class for the specified device interface id.
FromIdAsync(String, WiFiDirectConnectionParameters)
FromIdAsync(String, WiFiDirectConnectionParameters)
FromIdAsync(String, WiFiDirectConnectionParameters)
Creates an instance of the WiFiDirectDevice class for the specified device interface id with specific connection
parameters.
GetConnectionEndpointPairs()
GetConnectionEndpointPairs()
GetConnectionEndpointPairs()
Gets a collection of network addresses for the Wi-Fi Direct device as endpoint pairs.
GetDeviceSelector()
GetDeviceSelector()
GetDeviceSelector()
Returns the class selection string that you can use to enumerate Wi-Fi Direct devices.
GetDeviceSelector(WiFiDirectDeviceSelectorType)
GetDeviceSelector(WiFiDirectDeviceSelectorType)
GetDeviceSelector(WiFiDirectDeviceSelectorType)
Returns the class selection string that you can use to enumerate Wi-Fi Direct devices for a specific Wi-Fi Direct
device selector type.
Events
ConnectionStatusChanged
ConnectionStatusChanged
ConnectionStatusChanged
Returns
WiFiDirectConnectionStatus
The connection status for the WiFi-Direct device.
See WiFiDirectDevice sample
Also
WiFiDirectDevice.ConnectionStatusChanged WiFiDirect
Device.ConnectionStatusChanged WiFiDirectDevice.
ConnectionStatusChanged
I n this Article
Edit
Occurs when a Wi-Fi Direct device connection is connected or disconnected.
public : event TypedEventHandler<WiFiDirectDevice, object> ConnectionStatusChanged
// Register
event_token ConnectionStatusChanged(TypedEventHandler<WiFiDirectDevice, object> const& handler)
const;
Remarks
You can add a handler for the ConnectionStatusChanged event to be notified when the connection has been
established or disconnected.
See WiFiDirectDevice sample
Also
WiFiDirectDevice.DeviceId WiFiDirectDevice.DeviceId Wi
FiDirectDevice.DeviceId
I n this Article
Edit
Gets the DeviceInformation Id for the Wi-Fi Direct device.
public : Platform::String DeviceId { get; }
winrt::hstring DeviceId();
public string DeviceId { get; }
Returns
string
The DeviceInformation Id for the Wi-Fi Direct device.
See WiFiDirectDevice sample
Also
IDisposable.Dispose IDisposable.Dispose
I n this Article
Edit
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
Overloads
FromIdAsync(String) FromIdAsync(String) FromIdAsync(String)
Creates an instance of the WiFiDirectDevice class for the
specified device interface id.
Parameters
deviceId String
The DeviceInformation Id of a Wi-Fi Direct device.
Returns
IAsyncOperation<WiFiDirectDevice>
An asynchronous operation to retrieve the WiFiDirectDevice that was created.
Attributes OverloadAttribute RemoteAsyncAttribute
Remarks
You can use the GetDeviceSelector methods to enumerate Wi-Fi Direct devices to determine their interface ids.
See
Also
FromIdAsync(String, WiFiDirectConnectionParameters)FromIdAsync(String,
WiFiDirectConnectionParameters)FromIdAsync(String, WiFiDirectConnectionParameters)
WiFiDirectDevice sample
FromIdAsync(String, WiFiDirectConnectionParameters)
FromIdAsync(String, WiFiDirectConnectionParameters)
FromIdAsync(String, WiFiDirectConnectionParameters)
Edit
Creates an instance of the WiFiDirectDevice class for the specified device interface id with specific connection
parameters.
public : static IAsyncOperation<WiFiDirectDevice> FromIdAsync(Platform::String deviceId,
WiFiDirectConnectionParameters connectionParameters)
static IAsyncOperation<WiFiDirectDevice> FromIdAsync(winrt::hstring deviceId,
WiFiDirectConnectionParameters connectionParameters) const;
public static IAsyncOperation<WiFiDirectDevice> FromIdAsync(String deviceId,
WiFiDirectConnectionParameters connectionParameters)
Parameters
deviceId String
The DeviceInformation Id of a Wi-Fi Direct device.
connectionParameters WiFiDirectConnectionParameters
Connection parameters for a Wi-Fi Direct connect/pairing operation.
Returns
IAsyncOperation<WiFiDirectDevice>
An asynchronous operation to retrieve the WiFiDirectDevice that was created.
Attributes OverloadAttribute
Remarks
You can use the GetDeviceSelector methods to enumerate Wi-Fi Direct devices to determine their interface ids.
See FromIdAsync(String)FromIdAsync(String)FromIdAsync(String)
Also
WiFiDirectDevice.GetConnectionEndpointPairs WiFi
DirectDevice.GetConnectionEndpointPairs WiFiDirect
Device.GetConnectionEndpointPairs
I n this Article
Edit
Gets a collection of network addresses for the Wi-Fi Direct device as endpoint pairs.
public : IVectorView<EndpointPair> GetConnectionEndpointPairs()
IVectorView<EndpointPair> GetConnectionEndpointPairs() const;
public IReadOnlyList<EndpointPair> GetConnectionEndpointPairs()
Returns
IReadOnlyList<EndpointPair>
A collection of network addresses for the Wi-Fi Direct device as endpoint pairs.
See WiFiDirectDevice sample
Also
WiFiDirectDevice.GetDeviceSelector WiFiDirectDevice.
GetDeviceSelector WiFiDirectDevice.GetDeviceSelector
I n this Article
Overloads
GetDeviceSelector() GetDeviceSelector() GetDeviceSelector()
Returns the class selection string that you can use to
enumerate Wi-Fi Direct devices.
GetDeviceSelector(WiFiDirectDeviceSelectorType) GetDevice
Selector(WiFiDirectDeviceSelectorType) GetDeviceSelector(WiFi Returns the class selection string that you can use to
DirectDeviceSelectorType) enumerate Wi-Fi Direct devices for a specific Wi-Fi Direct
device selector type.
Returns
string
The class selection string that you can use to enumerate Wi-Fi Direct devices.
Attributes OverloadAttribute
Remarks
This method only returns Wi-Fi Direct device interfaces.
See
Also
WiFiDirectDeviceSelectorType)GetDeviceSelector(WiFiDirectDeviceSelectorType)GetDeviceSelector(WiFiDirectDeviceSelectorType)
GetDeviceSelector(WiFiDirectDeviceSelectorType)
GetDeviceSelector(WiFiDirectDeviceSelectorType)
GetDeviceSelector(WiFiDirectDeviceSelectorType)
Edit
Returns the class selection string that you can use to enumerate Wi-Fi Direct devices for a specific Wi-Fi Direct device
selector type.
public : static Platform::String GetDeviceSelector(WiFiDirectDeviceSelectorType type)
static winrt::hstring GetDeviceSelector(WiFiDirectDeviceSelectorType type) const;
public static string GetDeviceSelector(WiFiDirectDeviceSelectorType type)
Parameters
type WiFiDirectDeviceSelectorType
A specific Wi-Fi Direct device selector type.
Returns
string
The class selection string that you can use to enumerate Wi-Fi Direct devices.
Attributes OverloadAttribute
Remarks
This method will return either Wi-Fi Direct device interfaces or associated endpoints for PCs, tablets, and phones that
support Wi-Fi Direct depending on the value of the type parameter.
See GetDeviceSelector()GetDeviceSelector()GetDeviceSelector()
Also
WiFiDirectDeviceSelectorType WiFiDirectDeviceSelector
Type WiFiDirectDeviceSelectorType Enum
Specifies the device selector type for Wi-Fi Direct.
D eclaration
public : enum class WiFiDirectDeviceSelectorType
enum class winrt::Windows::Devices::WiFiDirect::WiFiDirectDeviceSelectorType : int32_t
public enum WiFiDirectDeviceSelectorType
I nheritance H ierarchy
None
Fields
AssociationEndpoint AssociationEndpoint An associated endpoint. This includes other PC, tablets,
AssociationEndpoint and phones.
D eclaration
public : enum class WiFiDirectError
enum class winrt::Windows::Devices::WiFiDirect::WiFiDirectError : int32_t
public enum WiFiDirectError
I nheritance H ierarchy
None
Fields
RadioNotAvailable RadioNotAvailable The Wi-Fi Direct radio was not available. This error occurs when the Wi-Fi
RadioNotAvailable Direct radio has been turned off.
ResourceInUse ResourceInUse The operation cannot be serviced because the necessary resources are
ResourceInUse currently in use.
D eclaration
public : sealed class WiFiDirectInformationElement : IWiFiDirectInformationElement
struct winrt::Windows::Devices::WiFiDirect::WiFiDirectInformationElement :
IWiFiDirectInformationElement
public sealed class WiFiDirectInformationElement : IWiFiDirectInformationElement
I nheritance H ierarchy
None
Remarks
An information element (IE ) is a form of structured data which can be included in Wi-Fi Direct packets. IEs are
formatted as a variable length value field preceded by type and length fields.
Constructors
WiFiDirectInformationElement()
WiFiDirectInformationElement()
WiFiDirectInformationElement()
Properties
Oui
Oui
Oui
A three-byte organization identifier used to indicate the organization which defined a vendor extension
information element (IE ).
OuiType
OuiType
OuiType
A one byte type value used in a vendor extension information element (IE ) to distinguish between different IE
formats defined by the same organization.
Value
Value
Value
CreateFromDeviceInformation(DeviceInformation)
CreateFromDeviceInformation(DeviceInformation)
CreateFromDeviceInformation(DeviceInformation)
Parameters
buffer IBuffer
The data buffer that contains a information element.
Returns
IList<WiFiDirectInformationElement>
A array of information elements created from the buffer.
WiFiDirectInformationElement.CreateFromDevice
Information WiFiDirectInformationElement.CreateFrom
DeviceInformation WiFiDirectInformationElement.Create
FromDeviceInformation
I n this Article
Edit
Create an array of information elements from a DeviceInformation object.
public : static IVector<WiFiDirectInformationElement> CreateFromDeviceInformation(DeviceInformation
deviceInformation)
static IVector<WiFiDirectInformationElement> CreateFromDeviceInformation(DeviceInformation
deviceInformation) const;
public static IList<WiFiDirectInformationElement> CreateFromDeviceInformation(DeviceInformation
deviceInformation)
Parameters
deviceInformation DeviceInformation
The device information object that contains the information elements.
Returns
IList<WiFiDirectInformationElement>
A array of information elements created from the device information object.
WiFiDirectInformationElement.Oui WiFiDirectInformation
Element.Oui WiFiDirectInformationElement.Oui
I n this Article
Edit
A three-byte organization identifier used to indicate the organization which defined a vendor extension information
element (IE ).
public : IBuffer Oui { get; set; }
IBuffer Oui();
Returns
IBuffer
A three-byte organization identifier used to indicate the organization which defined a vendor extension IE.
WiFiDirectInformationElement.OuiType WiFiDirect
InformationElement.OuiType WiFiDirectInformation
Element.OuiType
I n this Article
Edit
A one byte type value used in a vendor extension information element (IE ) to distinguish between different IE formats
defined by the same organization.
public : byte OuiType { get; set; }
byte OuiType();
Returns
byte
A one byte type value used in a vendor extension information element (IE ) to distinguish between different IE formats
defined by the same organization.
WiFiDirectInformationElement.Value WiFiDirect
InformationElement.Value WiFiDirectInformationElement.
Value
I n this Article
Edit
The value of the information element.
public : IBuffer Value { get; set; }
IBuffer Value();
Returns
IBuffer
The value of the information element.
WiFiDirectInformationElement WiFiDirectInformation
Element WiFiDirectInformationElement
I n this Article
Edit
Creates a new WiFiDirectInformationElement object.
public : WiFiDirectInformationElement()
WiFiDirectInformationElement() const;
public WiFiDirectInformationElement()
WiFiDirectLegacySettings WiFiDirectLegacySettings WiFi
DirectLegacySettings Class
Settings governing "legacy" mode (non-Wi-Fi Direct connections to the access point being advertised.)
This access point allows devices that do not support Wi-Fi Direct to connect to a device that does support it, and to use
the services offered by the Wi-Fi Direct device. The connection does not serve as a general-purpose Wi-Fi access point.
D eclaration
public : sealed class WiFiDirectLegacySettings : IWiFiDirectLegacySettings
struct winrt::Windows::Devices::WiFiDirect::WiFiDirectLegacySettings : IWiFiDirectLegacySettings
public sealed class WiFiDirectLegacySettings : IWiFiDirectLegacySettings
I nheritance H ierarchy
None
Remarks
Your code retrieves instances of this class through the WiFiDirectAdvertisement.LegacySettings property. It does not
instantiate the class directly.
The SSID is initially set to a Wi-Fi Direct compatible random string beginning with ""DIRECT-"". Your code can change
this value to a different SSID if you choose to do so.
The pass phrase is initialized to a random alphanumeric string. Your code can change this value to a different pass
phrase if you choose to do so.
Windows 10, version 1607, supports Mobile Hotspot, an enhanced version of the mobile broadband tethering feature.
If an application uses functionality of the WiFiDirectLegacySettings class to start the Wi-Fi Direct group owner role,
if the Mobile Hotspot is subsequently started, the functionality of this class is not supported. It is likely to stop working.
The Mobile Hotspot and Wi-Fi Direct technology cannot run at the same time. Mobile Hotspot takes precedence over
all Wi-Fi Direct scenarios.
Properties
IsEnabled
IsEnabled
IsEnabled
Gets or sets a value specifying whether "legacy mode" is enabled. When enabled, this mode causes this device to
act as a normal Wi-Fi access point, and is intended to support devices which do not support connection via Wi-Fi
Direct.
Passphrase
Passphrase
Passphrase
Gets or sets the pass phrase used by non-Wi-Fi Direct clients to connect to this access point in "legacy mode".
Ssid
Ssid
Ssid
Gets or sets the Service Set Identifier (SSID, or "access point ID").
WiFiDirectLegacySettings.IsEnabled WiFiDirectLegacy
Settings.IsEnabled WiFiDirectLegacySettings.IsEnabled
I n this Article
Edit
Gets or sets a value specifying whether "legacy mode" is enabled. When enabled, this mode causes this device to act as
a normal Wi-Fi access point, and is intended to support devices which do not support connection via Wi-Fi Direct.
public : Platform::Boolean IsEnabled { get; set; }
bool IsEnabled();
Returns
bool
When true, "legacy mode" is enabled.
WiFiDirectLegacySettings.Passphrase WiFiDirectLegacy
Settings.Passphrase WiFiDirectLegacySettings.Passphrase
I n this Article
Edit
Gets or sets the pass phrase used by non-Wi-Fi Direct clients to connect to this access point in "legacy mode".
public : PasswordCredential Passphrase { get; set; }
PasswordCredential Passphrase();
Returns
PasswordCredential
The pass phrase for the Wi-Fi network. This access point functions as a normal Wi-Fi access point, and is intended to
support devices which do not support connection via Wi-Fi Direct.
Remarks
Windows 10 and Windows 10 Mobile can be configured to allow embedded mode, which allows a device to run a
single app. If embedded mode is configured, the Passphrase value can be explicitly set to null to support Open/None
Authentication. Not all Wi-Fi adapters may support this feature on Windows. For more information, see Embedded
mode.
WiFiDirectLegacySettings.Ssid WiFiDirectLegacySettings.
Ssid WiFiDirectLegacySettings.Ssid
I n this Article
Edit
Gets or sets the Service Set Identifier (SSID, or "access point ID").
public : Platform::String Ssid { get; set; }
winrt::hstring Ssid();
Returns
string
The SSID for the access point. This access point functions as a normal Wi-Fi access point, and is intended to support
devices which do not support connection via Wi-Fi Direct.
WiFiDirectPairingProcedure WiFiDirectPairingProcedure
WiFiDirectPairingProcedure Enum
Specifies a direct pairing procedure.
Wi-Fi Direct supports two different pairing procedures. In the Group Owner Negotiation procedure, the connecting
device chooses the configuration method (PIN entry, PIN display, or pushbutton pairing.) In the P2P Invitation
procdure, the accepting device chooses the configuration method. Use the values in this enumeration to identify a
pairing procedure.
D eclaration
public : enum class WiFiDirectPairingProcedure
enum class winrt::Windows::Devices::WiFiDirect::WiFiDirectPairingProcedure : int32_t
public enum WiFiDirectPairingProcedure
I nheritance H ierarchy
None
Fields
GroupOwnerNegotiation GroupOwnerNegotiation Group Owner Negotiation. The connecting device chooses the
GroupOwnerNegotiation configuration method.
Invitation Invitation Invitation P2P Invitation. The accepting device chooses the
configuration method.