Edit

Share via

802.11 WLAN Adapter Reset

  • Article

 

The operating system calls Dot11ExtIhvAdapterReset whenever it becomes necessary to restore the wireless LAN (WLAN) adapter to its initialized state. The operating system calls this function whenever one of the following events occurs.

  • The WLAN adapter performs a disconnection operation. For more information about this operation, see Disconnection Operations.

  • The operating system resets the Native 802.11 miniport driver, which manages the adapter, through a set request of OID_DOT11_RESET_REQUEST.

When Dot11ExtIhvAdapterReset is called, the IHV Extensions DLL must follow these guidelines.

  • The IHV Extensions DLL must restore its state to the same state it was in after the Dot11ExtIhvInitAdapter function was called. If the DLL configured proprietary settings on the WLAN adapter, it must restore these settings to the same state they were in after Dot11ExtIhvInitAdapter was called.

  • If the IHV Extensions DLL had a pending pre-association operation, which was initiated through a call to the Dot11ExtIhvPerformPreAssociate IHV Handler function, the DLL must call Dot11ExtPreAssociateCompletion to cancel the operation. In this situation, the DLL sets the dwWin32Error parameter of Dot11ExtPreAssociateCompletion to ERROR_CANCELLED.

    For more information about the pre-association operation, see Pre-Association Operations.

  • If the DLL had a pending post-association operation, which was initiated through a call to the Dot11ExtIhvPerformPostAssociate IHV Handler function, the DLL must call Dot11ExtPostAssociateCompletion to cancel the operation. In this situation, the DLL sets the dwWin32Error parameter of Dot11ExtPostAssociateCompletion to ERROR_CANCELLED.

    For more information about the post-association operation, see Post-Association Operations.