_DOT11_WFD_DEVICE_ENTRY structure

Description

[!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 DOT11_WFD_DEVICE_ENTRY structure contains information about a discovered Wi-Fi Direct (WFD) device, a discovered WFD Group Owner (GO), or a discovered infrastructure access point. This structure is returned from both an OID_DOT11_WFD_ENUM_DEVICE_LIST and a NDIS_STATUS_DOT11_WFD_DISCOVER_COMPLETE notification.

Members

uPhyId

The identifier of the PHY the miniport used to detect the device. This identifier is in the index range of the list of supported PHYs returned from an OID_DOT11_SUPPORTED_PHY_TYPES query request. This identifier cannot be DOT_PHY_ID_ANY.

PhySpecificInfo

The attributes of the PHY identified by uPhyId.

dot11BSSID

The MAC address of the device that sent the beacon or probe response packet during a discovery.

dot11BSSType

The BSS network type. This member is set to dot11_BSS_type_infrastructure for all discovered WFD devices and WFD GOs.

TransmitterAddress

The MAC address for the transmitter of the device that sent the beacon or probe response packet during a discovery.

lRSSI

The received signal strength indicator value of the discovered device. The units for this value are in decibels referenced to 1 milliwatt (dBm).

uLinkQuality

Link quality value ranging from 0 to 100. A value of 100 indicates highest link quality.

usBeaconPeriod

The value received from the beacon interval field of the most recent beacon or probe response packet.

ullTimestamp

The value received from the timestamp field of the most recent beacon or probe response packet.

ullBeaconHostTimestamp

The timestamp, determined by a value returned from NdisGetCurrentSystemTime, recording the time when the beacon packet was received.

ullProbeResponseHostTimestamp

The timestamp, determined by a value returned from NdisGetCurrentSystemTime, recording the time when the probe response packet was received.

usCapabilityInformation

The value received from the capability field of the most recent beacon or probe response packet.

uBeaconIEsOffset

The offset, in bytes, from the beginning of this structure of the list of information elements (IEs) from the last beacon packet received from this device. If no beacon packet was received, this value should be 0.

uBeaconIEsLength

The length, in bytes, of the IEs at uBeaconIEsOffset. This is an exact length value and contains no padding for alignment. If no beacon packet was received, this value should be 0.

uProbeResponseIEsOffset

The offset, in bytes, from the beginning of this structure of the list of information elements (IEs) from the last probe response packet received from this device. If no beacon packet was received, this value should be 0.

uProbeResponseIEsLength

The length, in bytes, of the IEs at uProbeResponseIEsOffset. This is an exact length value and contains no padding for alignment. If no probe response packet was received, this value should be 0.

Syntax

typedef struct _DOT11_WFD_DEVICE_ENTRY {
  ULONG                             uPhyId;
  DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO PhySpecificInfo;
  DOT11_MAC_ADDRESS                 dot11BSSID;
  DOT11_BSS_TYPE                    dot11BSSType;
  DOT11_MAC_ADDRESS                 TransmitterAddress;
  LONG                              lRSSI;
  ULONG                             uLinkQuality;
  USHORT                            usBeaconPeriod;
  ULONGLONG                         ullTimestamp;
  ULONGLONG                         ullBeaconHostTimestamp;
  ULONGLONG                         ullProbeResponseHostTimestamp;
  USHORT                            usCapabilityInformation;
  ULONG                             uBeaconIEsOffset;
  ULONG                             uBeaconIEsLength;
  ULONG                             uProbeResponseIEsOffset;
  ULONG                             uProbeResponseIEsLength;
}  DOT11_WFD_DEVICE_ENTRY, *PDOT11_WFD_DEVICE_ENTRY;

See also

DOT11_BSS_TYPE

NDIS_STATUS_DOT11_WFD_DISCOVER_COMPLETE

OID_DOT11_WFD_ENUM_DEVICE_LIST

OID_DOT11_SUPPORTED_PHY_TYPES

DOT11_MAC_ADDRESS

DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO

NdisGetCurrentSystemTime