DOT11_BSS_ENTRY structure (windot11.h)
Syntax
typedef struct DOT11_BSS_ENTRY {
ULONG uPhyId;
DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO PhySpecificInfo;
DOT11_MAC_ADDRESS dot11BSSID;
DOT11_BSS_TYPE dot11BSSType;
LONG lRSSI;
ULONG uLinkQuality;
BOOLEAN bInRegDomain;
USHORT usBeaconPeriod;
ULONGLONG ullTimestamp;
ULONGLONG ullHostTimestamp;
USHORT usCapabilityInformation;
ULONG uBufferLength;
UCHAR ucBuffer[1];
} DOT11_BSS_ENTRY, *PDOT11_BSS_ENTRY;
Members
uPhyId
The identifier (ID) of the PHY that the 802.11 station used to detect the BSS network. The PHY ID is the index within the list of supported PHYs returned by the driver through a query of OID_DOT11_SUPPORTED_PHY_TYPES.
This ID must not be DOT11_PHY_ID_ANY.
PhySpecificInfo
The attributes of the PHY referenced by the uPhyId member. PhySpecificInfo is formatted as a DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO union.
dot11BSSID
The media access control (MAC) address of the access point (AP) (for infrastructure BSS networks) or peer station (for independent BSS networks) that sent the 802.11 Beacon or Probe Response frame received by the 802.11 station while scanning. The data type for this member is the DOT11_MAC_ADDRESS structure.
dot11BSSType
The BSS network type.
The data type for this member is the DOT11_BSS_TYPE enumeration. The miniport driver must not set this member to the dot11_BSS_type_any value.
lRSSI
The received signal strength indicator (RSSI) value, in units of decibels referenced to 1.0 milliwatts (dBm), as detected by the 802.11 station for the AP or peer station.
uLinkQuality
The link quality value ranging from 0 through 100. A value of 100 specifies the highest link quality. For more information about determining the link quality, see Link Quality Operations.
bInRegDomain
This member specifies whether the AP or peer station is operating within the regulatory domain as identified by the input country string. To set this member, the miniport driver must use the following guidelines:
- If the 802.11 station does not support multiple regulatory domains, set the member to TRUE. For more information about multiple regulatory domains, see OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED.
- If the input country string is all zeros, set the member to TRUE.
- If the AP or peer station is not operating on a channel that is valid for the regulatory domain specified by the input country string, set the member to FALSE.
-
If the 802.11 Beacon or Probe Response frame, which was received from the AP or peer station,
doesn't include a Country information element (IE), set the member to TRUE.
For more information about the Country IE, refer to Clause 7.3.2.12 of the IEEE 802.11d-2001 standard.
- If the 802.11 Beacon or Probe Response frame, which was received from the AP or peer station, does include a Country IE, set the member to FALSE if the value of the Country String subfield does not equal the input country string.
- Set the member to TRUE in all other cases.
usBeaconPeriod
The value of the Beacon Interval field from the 802.11 Beacon or Probe Response frame.
ullTimestamp
The value of the Timestamp field from the 802.11 Beacon or Probe Response frame.
ullHostTimestamp
The timestamp, resolved through a call to NdisGetCurrentSystemTime, which records when the 802.11 station received the 802.11 Beacon or Probe Response frame.
usCapabilityInformation
The value of the Capability Information field from the 802.11 Beacon or Probe Response frame.
uBufferLength
The length, in bytes, of the ucBuffer array in the DOT11_BSS_ENTRY structure. ulBufferLength must be the exact length of the data in the ucBuffer array and must not contain any padding for alignment.
ucBuffer[1]
The variable-length information elements (IEs) from the 802.11 Beacon or Probe Response frames. For each BSS, the IEs must be from the last Beacon or Probe Response frame received from that BSS network. If an IE is available in only one frame, the miniport driver must merge the IE with the other IEs from the last received Beacon or Probe Response frame.
When the NIC is in the Extensible Access Point (ExtAP) OP mode, the BSS list should contain an entry for the BSS that the NIC created.
For more information about the fields within IEEE 802.11 Beacon or Probe Response frames, refer to Clause 8.4 of the IEEE 802.11-2012 standard.
Remarks
When the 802.11 station performs a scan operation, the Native 802.11 miniport driver caches the received 802.11 Beacon and Probe Response frames. For more information about the scan operation, see Native 802.11 Scan Operations.
After the 802.11 station completes the scan operation, the miniport driver returns the list of the cached Beacon and Probe Response frames when queried by OID_DOT11_ENUM_BSS_LIST. A separate DOT11_BSS_ENTRY structure is formatted for each Beacon and Probe Response frame.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows Vista and later versions of the Windows operating systems. |
| Header | windot11.h (include Ndis.h) |
See also
OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED DOT11_BSS_ENTRY_PHY_SPECIFIC_INFOFeedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for