Export (0) Print
Expand All
Expand Minimize

DOT11_BSS_ENTRY (Compact 2013)

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.


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;

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.

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 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.

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.

Header

windot11.h

Show:
© 2015 Microsoft