DOT11_BSS_ENTRY (Compact 2013)

  • Article

3/26/2014

This structure defines an IEEE 802.11 Beacon or Response Frame that the 802.11 station received during its last scan operation.

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.
  • 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 it scans. The data type for this member is the DOT11_MAC_ADDRESS structure.
  • 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.

  • bInRegDomain
    This member specifies whether the AP or peer station is operating within the regulatory domain as identified by the input country/region 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/region 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/region string, set the member to FALSE.
    • If the 802.11 Beacon or Probe Response frame. This was received from the AP or peer station, does not include a country/region information element (IE), set the member to TRUE.
    • For more information about the country/region 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/region IE, set the member to FALSE if the value of the country/region string subfield does not equal the input country/region 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 time stamp, 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
    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.

    For more information about the fields within IEEE 802.11 Beacon or Probe Response frames, refer to Clause 7.3 of the IEEE 802.11‑1999 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.

After the 802.11 station finishes 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

Header

windot11.h

See Also

Reference

Native 802.11 Data Types
OID_DOT11_SUPPORTED_PHY_TYPES
DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO
OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED
NdisGetCurrentSystemTime
DOT11_BSS_ENTRY
OID_DOT11_ENUM_BSS_LIST
Native 802.11 Wireless LAN Reference

Other Resources

DOT11_MAC_ADDRESS