OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST (Compact 2013)

  • Article

3/26/2014

When set, the OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST object identifier (OID) requests that the miniport driver set the value of the Extensible Station (ExtSTA) msDot11ExcludedMacAddressList management information base (MIB) object to the specified data.

When queried, OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST requests that the miniport driver return the value of the msDot11ExcludedMacAddressList MIB object.

The msDot11ExcludedMacAddressList MIB object specifies the list of media access control (MAC) addresses of remote stations that the 802.11 station must not connect to. When OID_DOT11_CONNECT_REQUEST is set, the 802.11 station must try to connect with any remote station, such as an access point (AP) in an infrastructure basic service set (BSS) network or peer station in an independent BSS (IBSS) network, that does not have a MAC address within the excluded MAC address list.

The data type for OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST is the DOT11_MAC_ADDRESS_LIST structure.

A wildcard MAC address has the value of 0xFFFFFFFFFFFF. The wildcard MAC address matches the MAC address of any AP or peer station. If the excluded MAC address list contains the wildcard MAC address, the 802.11 station must not connect to any AP or peer station.

Note

A list of excluded MAC address that contains the wildcard MAC address must be the only entry in the list.

When OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST is set, the miniport driver must:

  • Fail the set request if the excluded MAC address list contains the wildcard MAC address but the uNumOfEntries member is not set to one. In this situation, the miniport driver must return NDIS_STATUS_INVALID_DATA from its MiniportOidRequest function.
  • Fail the set request if the uNumOfEntries member has a value greater than the value of uExcludedMacAddressListSize that the driver previously returned through a query of OID_DOT11_EXTSTA_CAPABILITY. In this situation, the miniport driver must return NDIS_STATUS_INVALID_LENGTH from its MiniportOidRequest function.
  • Overwrite the 802.11 station’s excluded MAC address list by using the entries from the MacAddrs array. If an entry has the MAC address of the AP or peer station that the 802.11 station is connected to, the 802.11 station must disassociate and roam to another station.

When OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST 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_MAC_ADDRESS_LIST structure. This includes all entries in the MacAddrs 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_MAC_ADDRESS_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 MacAddrs array
    • For the OidRequest parameter, set the BytesWritten member to zero and the BytesNeeded member to the length, in bytes, of the complete DOT11_MAC_ADDRESS_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_MAC_ADDRESS_LIST structure, the miniport driver must do the following to complete a successful query request:
    • For the DOT11_MAC_ADDRESS_LIST structure, set the uNumOfEntries and uTotalNumOfEntries members to the total number of entries in the MacAddrs array
    • For the OidRequest parameter, set the BytesNeeded member to zero and the BytesWritten member to the length, in bytes, of the complete DOT11_MAC_ADDRESS_LIST structure. The miniport driver must also copy the complete DOT11_MAC_ADDRESS_LIST structure to the InformationBuffer member.
    • Return NDIS_STATUS_SUCCESS from its MiniportOidRequest function

The default for the msDot11ExcludedMacAddressList MIB object is an empty list that has uNumEntries set to zero. The miniport driver must set this MIB object to its default if any of the following occur:

Requirements

Header

windot11.h

See Also

Reference

Native 802.11 Extensible Station OIDs
OID_DOT11_CONNECT_REQUEST
DOT11_MAC_ADDRESS_LIST
MiniportOidRequest
OID_DOT11_EXTSTA_CAPABILITY
MiniportInitializeEx
OID_DOT11_RESET_REQUEST
DOT11_RESET_REQUEST
Native 802.11 Wireless LAN OIDs