DOT11_WFD_DISCOVER_REQUEST structure (windot11.h)

Article
09/14/2024

Important

WiFiCx is the new Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features. The WDI driver model is now in maintenance mode and will only receive high priority fixes.

The OID_DOT11_WFD_DISCOVER_REQUEST structure is the input data for an OID_DOT11_WFD_DISCOVER_REQUEST request. The structure contains the parameters for a Wi-Fi Direct device discovery.

Syntax

typedef struct _DOT11_WFD_DISCOVER_REQUEST {
  NDIS_OBJECT_HEADER      Header;
  DOT11_WFD_DISCOVER_TYPE DiscoverType;
  DOT11_WFD_SCAN_TYPE     ScanType;
  ULONG                   uDiscoverTimeout;
  ULONG                   uDeviceFilterListOffset;
  ULONG                   uNumDeviceFilters;
  ULONG                   uIEsOffset;
  ULONG                   uIEsLength;
  BOOLEAN                 bForceScanLegacyNetworks;
} DOT11_WFD_DISCOVER_REQUEST, *PDOT11_WFD_DISCOVER_REQUEST;

Members

Header

The type, revision, and size of theOID_DOT11_WFD_DISCOVER_REQUEST structure. This member is formatted as an NDIS_OBJECT_HEADER structure.

The miniport driver must set the members of Header to the following values:

Type

This member must be set to NDIS_OBJECT_TYPE_DEFAULT.

Revision

This member must be set to DOT11_WFD_DISCOVER_REQUEST_REVISION_1.

Size

This member must be set to sizeof(DOT11_SIZEOF_WFD_DISCOVER_REQUEST_REVISION_1).

For more information about these members, see NDIS_OBJECT_HEADER.

DiscoverType

The device discovery mode to use.

ScanType

Scanning type used during the scan phase of device discovery.

uDiscoverTimeout

Maximum time, in milliseconds, to complete the discovery operation. A miniport can complete a discovery in less time, however, it should not use any more time than specified by this value. This is the total time allowed for completion of all phases of device discovery.

uDeviceFilterListOffset

The offset to the list of P2P Device filters, which specifies the P2P devices and Group Owners to search for during Wi-Fi Direct device discovery. This offset is specified in bytes and is relative to the start of the buffer that contains the DOT11_WFD_DISCOVER_REQUEST structure. Each entry in the list is formatted as a DOT11_WFD_DISCOVER_DEVICE_FILTER.

When a list entry specifies a non-broadcast MAC address as the Device ID, the driver must use this MAC address in the Device ID Attribute of the P2P IEs it includes in the probe requests.

The offset in the InformationBuffer of the NDIS_OID_REQUEST where a list of P2P device identifiers begins. These are the identifiers to for during device discovery.

uNumDeviceFilters

The number of P2P device filters to use during WFD device discovery. The default value for this field is 0.

uIEsOffset

The offset in the InformationBuffer of the NDIS_OID_REQUEST structure where the additional Informational Elements (IEs) begin.

uIEsLength

The length, in bytes, of the additional IEs which the Wi-Fi Direct device port must add to the probe request packet. If this value is 0, the system did not provide any IEs and the miniport must insert the default IEs in the probe request packet. The default IEs are in DefaultRequestIEs received earlier with an OID_DOT11_WFD_ADDITIONAL_IE request.

bForceScanLegacyNetworks

When TRUE, the Wi-Fi Direct device must also attempt to discover legacy networks. Otherwise, scanning for legacy networks is not necessary.

Remarks

Each entry in the device identifier list at uDeviceFilterListOffset is formatted as a DOT11_MAC_ADDRESS structure. When a non-broadcast MAC address is specified in this list, the driver must use this address in the Device ID attribute of the P2P IEs probe requests it transmits

The IEs present at uIEsOffset, for the duration of the device discovery, will temporarily replace IEs found at DefaultRequestIEs in input structure of the OID_DOT11_WFD_ADDITIONAL_IE request.

Requirements

Requirement	Value
Minimum supported client	Versions:_Supported in Windows 8
Header	windot11.h (include Windot11.h)

Share via