Share via


OID_DOT11_WFD_LISTEN_STATE_DISCOVERABILITY

Important  The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.

 

When set, the OID_DOT11_WFD_LISTEN_STATE_DISCOVERABILITY object identifier (OID) is used to set the discoverability state of a Wi-Fi Direct (WFD) device and to configure its availability settings.

The data type for OID_DOT11_WFD_LISTEN_STATE_DISCOVERABILITY is a ULONG availability value.

The WFD availability is set to one of the following values.

Term Description

DOT11_WFD_DEVICE_NOT_DISCOVERABLE

The WFD device port must remain undiscoverable. The device must not periodically put itself in the listen state to allow other devices to discover it. This is the default availability setting.

DOT11_WFD_DEVICE_AUTO_AVAILABILITY

The WFD device port must periodically put itself in the listen state to become discoverable. It must use appropriate availability periods to balance power, discoverability, and performance of the WFD ports and other ports on the miniport. It must follow the availability guidelines in the Wi-Fi Direct Peer-To-Peer Technical Specification.

DOT11_WFD_DEVICE_HIGH_AVAILABILITY

The WFD device port must frequently put itself into the listen state for an extended duration to increase the speed and reliability of remote devices discovering it. For example, a remote device that periodically scans the listen channel at 250ms intervals should discover the device within no more than 250ms. To achieve this, the device may be available on the listen channel for a contiguous 300ms every 400ms. The DOT11_WFD_DEVICE_HIGH_AVAILABILITY setting must not result in loss of connectivity on the ExtSTA (infrastructure) or any Wi-Fi Direct ports. It is, however, expected that this setting may degrade the performance of these connections in terms of latency and throughput.

 

Responding to the OID_DOT11_WFD_LISTEN_STATE_DISCOVERABILITY request is only applicable when the WFD port is in device mode. When the port is in Group Owner (GO) mode and the group is started, it must be discoverable as required by the Wi-Fi Peer-To-Peer Technical Specification.

When the WFD device is discoverable, the miniport driver selects a listen channel. After the miniport sets the device to discoverable, it should transition in and out of the listen state as required by the Wi-Fi Direct Peer-To-Peer Technical Specification.

On initialization, the WFD port must use the default availability setting, DOT11_WFD_DEVICE_NOT_DISCOVERABLE, to determine its behavior.

Requirements

Version

Supported starting with Windows 8.

Header

Windot11.h (include Windot11.h)