Partager via

MAC/PHY Reset Operation

  • Article

Important  The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.

 

When a method request of OID_DOT11_RESET_REQUEST is made, the parameters for the reset request are defined through the DOT11_RESET_REQUEST structure. Based on the values of the members of this structure, the miniport driver must:

  • Reset either the media access control (MAC) and/or the PHY layers on the 802.11 station. The dot11ResetType member defines which layers the driver will reset.

    If the miniport driver is operating in Extensible Station (ExtSTA) mode, only a reset of both the MAC and all PHY layers is allowed. The driver must fail the method request of OID_DOT11_RESET_REQUEST by returning NDIS_STATUS_FAILURE from its MiniportOidRequest function if the dot11ResetType member is not set to dot11_reset_type_phy_and_mac.

  • Set the MAC address used by the 802.11 station to the address specified in the dot11MacAddress member. In this way, the 802.11 station can be configured with a locally administered MAC address to override the NIC's permanent MAC address.

  • If the bSetDefaultMIB member is TRUE, restore the 802.11 and Native 802.11 MIB objects to their specified default values for the IEEE layers undergoing a reset.

Regardless of the parameters for the reset request, the miniport driver must always do the following when a method request of OID_DOT11_RESET_REQUEST is made:

  • If connected, disconnect from its basic service set (BSS) network connection.

    If the miniport driver is operating in Extensible Station (ExtSTA) mode, it must issue the indications required for the disconnection operation. For more information about the disconnection operation, see Disconnection Operations.

  • Cancel any explicit scan operations in progress that were initiated through a set of OID_DOT11_SCAN_REQUEST. The miniport driver is not required to terminate any implicit scan operations initiated by the 802.11 station.

    The miniport driver must also clear the cached list of BSS networks that it detected during the previous scan operations.

    For more information about the scan operation, see Native 802.11 Scan Operations.

  • Flush all pending packets within its transmit queue and complete them through calls to NdisMSendNetBufferListsComplete. For each NET_BUFFER_LIST structure completed through this call, the miniport driver must set the Status member to NDIS_STATUS_RESET_IN_PROGRESS.

  • Flush all pending packets from its receive queue that have not been indicated through calls to NdisMSendNetBufferListsComplete.

    In addition, the miniport driver must not complete the method request of OID_DOT11_RESET_REQUEST until all previously indicated receive packets have been returned through calls to MiniportReturnNetBufferLists.

  • Clear any cipher keys previously downloaded to the 802.11 station through set requests of Native 802.11 object identifiers (OIDs). The driver must clear all cipher key tables on the station, including the default cipher, per station and key-mapping keys.

  • Clear all entries from the pairwise master key identifier (PMKID) cache supported by the 802.11 station.

  • Transition to the initialization (INIT) state of the currently configured Native 802.11 operation mode.

If the miniport driver is operating in Extensible Station (ExtSTA) mode, it must do the following when a method request of OID_DOT11_RESET_REQUEST is made:

  • Reset and clear all statistical counters queried through OID_DOT11_STATISTICS. For more information about 802.11 statistics, see Native 802.11 Statistics.

  • Cancel any pending network operations, such as a roaming or connection operations. For more information about these operations, see Native 802.11 Network Operations.

  • Clear the cache of BSS networks that have resulted from previous scan operations. The BSS network cache is queried through OID_DOT11_ENUM_BSS_LIST.

  • Clear the cache of pairwise master key identifiers (PMKID) if the 802.11 station supports PMKID caching. The PMKID cache is set or queried through OID_DOT11_PMKID_LIST.