Share via

OID_DOT11_ENUM_BSS_LIST (Compact 2013)

  • Article

3/26/2014

When a method request of the OID_DOT11_ENUM_BSS_LIST OID is made, the miniport driver must return a list of the basic service set (BSS) networks within range of the 802.11 station. For more information about the method request type, see NDIS_OID_REQUEST.

The miniport driver derives this list from the cache of BSS networks that the 802.11 station detected during the most recent scan operation. For more information about scan operations, see OID_DOT11_SCAN_REQUEST.

When the method request of OID_DOT11_ENUM_BSS_LIST is made through a call to the miniport driver’s MiniportOidRequest function, the InformationBuffer member of the OidRequest parameter contains a three-character country/region string as defined in the IEEE 802.11d-2001 standard. For more information about country/region strings, see OID_DOT11_COUNTRY_STRING.

The miniport driver finishes the method request by overwriting the InformationBuffer member with a DOT11_BYTE_ARRAY structure. Each entry in the BSS list is formatted as a DOT11_BSS_ENTRY structure.

When this OID is queried, the miniport driver must do the following:

  • Verify that the InformationBuffer member of its MiniportOidRequest function’s OidRequest parameter is large enough to return the BSS list. For more information about this procedure, see DOT11_BYTE_ARRAY.

  • The DOT11_BSS_ENTRY structure has a variable length. However, the miniport driver must not add padding for alignment between DOT11_BSS_ENTRY structures returned in the InformationBuffer member of the OidRequest parameter.

  • Use the following formula for calculating the values of the uNumOfBytes and uTotalNumOfBytes members of the DOT11_BYTE_ARRAY structure:

    FIELD_OFFSET(DOT11_BSS_ENTRY, ucBuffer) + uBufferLength

  • If the 802.11 station is connected to an infrastructure BSS network, include an entry in the BSS list for the AP with which the 802.11 station is currently associated. The DOT11_BSS_ENTRY entry must reflect the last 802.11 Beacon or Probe Response frame received from the AP, regardless of whether these frames were received when the Native 802.11 miniport driver was performing the scan operation.

Requirements

Header

windot11.h

See Also

Reference

Native 802.11 Extensible Station OIDs
NDIS_OID_REQUEST
OID_DOT11_SCAN_REQUEST
MiniportOidRequest
OID_DOT11_COUNTRY_STRING
DOT11_BYTE_ARRAY
DOT11_BSS_ENTRY
NDIS_OBJECT_HEADER
MiniportOidRequest
Native 802.11 Wireless LAN OIDs