Share via

OID_DOT11_ENUM_ASSOCIATION_INFO (Compact 7)

  • Article

3/12/2014

When queried, the OID_DOT11_ASSOCIATION_INFO object identifier (OID) requests that the miniport driver return a list of the access point (AP) (for infrastructure basic service set (BSS) networks) or all peer stations (for independent BSS (IBSS) networks) with which the 802.11 station is associated.

The data type for this OID is the DOT11_ASSOCIATION_INFO_LIST structure. If the desired BSS type is dot11_BSS_type_infrastructure, the association information list must contain DOT11_ASSOCIATION_INFO_EX data for only the AP with which the 802.11 station is associated. If the 802.11 station is not associated, the miniport driver must return an empty list and set the uNumOfEntries member to zero.

If the desired BSS type is dot11_BSS_type_independent, the association information list must contain DOT11_ASSOCIATION_INFO_EX data for every peer station in the IBSS with which the 802.11 station has connected.

When OID_DOT11_ASSOCIATION_INFO is queried, the miniport driver must verify that the InformationBuffer member of the MiniportOidRequest function’s OidRequest parameter is large enough to return the complete DOT11_ASSOCIATION_INFO_LIST structure. This includes all entries in the dot11AssocInfo array. The value of the InformationBufferLength member of the OidRequest parameter determines what the miniport driver must do, as the following list shows:

  • If the value of the InformationBufferLength member is less than the length, in bytes, of the complete DOT11_ASSOCIATION_INFO_LIST structure, the miniport driver must do the following:
    • Set the uNumOfEntries member to zero
    • Set the uTotalNumOfEntries member to the number of entries in the dot11AssocInfo array
      For the OidRequest parameter, set the BytesWritten member to zero and the BytesNeeded member to the length, in bytes, of the complete DOT11_ASSOCIATION_INFO_LIST structure.
    • Fail the query request by returning NDIS_STATUS_BUFFER_OVERFLOW from its MiniportOidRequest function
  • If the value of the InformationBufferLength member is greater than or equal to than the length, in bytes, of the complete DOT11_ASSOCIATION_INFO_LIST structure, the miniport driver must do the following to complete a successful query request:
    • For the DOT11_ASSOCIATION_INFO_LIST structure, set the uNumOfEntries and uTotalNumOfEntries members to the total number of entries in the dot11AssocInfo array.
    • For the OidRequest parameter, set the BytesNeeded member to zero and the BytesWritten member to the length, in bytes, of the complete DOT11_ASSOCIATION_INFO_LIST structure. The miniport driver must also copy the complete DOT11_ASSOCIATION_INFO_LIST structure to the InformationBuffer member.
    • Return NDIS_STATUS_SUCCESS from its MiniportOidRequest function.

Requirements

Header

windot11.h

See Also

Reference

Native 802.11 Extensible Station OIDs
DOT11_ASSOCIATION_INFO_LIST
DOT11_ASSOCIATION_INFO_EX
NDIS_OBJECT_HEADER
OID_DOT11_DATA_RATE_MAPPING_TABLE
DOT11_POWER_MODE
NdisGetCurrentSystemTime
MiniportOidRequest
Native 802.11 Wireless LAN OIDs