OID_DOT11_RESET_REQUEST (Compact 2013)

Article
07/31/2017

3/26/2014

When a method request of the OID_DOT11_RESET_REQUEST OID is made, the miniport driver must reset the specified IEEE layers of the 802.11 station and transition to the initialization (INIT) state of the current operation mode. For more information about the method request type, see NDIS_OID_REQUEST.

The data type for this OID is the DOT11_RESET_REQUEST structure.

When the method request of OID_DOT11_RESET_REQUEST is made, the miniport driver can do one of the following:

Wait for the reset operation to complete before completing the set request
Initiate the reset operation and complete the set request. In this case, the miniport driver must return NDIS_STATUS_PENDING from its MiniportOidRequest function after initiating the reset operation. After the reset operation has finished, the miniport driver finishes the set request by calling NdisMRequestComplete.

When the method request of OID_DOT11_RESET_REQUEST is made, the miniport driver must do the following regardless of the value of dot11ResetType:

Fail the query request if the value of the InformationBufferLength member of the MiniportOidRequest function is less than the length, in bytes, of the DOT11_STATUS_INDICATION structure. In this situation, the miniport driver returns NDIS_STATUS_BUFFER_OVERFLOW from the MiniportOidRequest function.
Disconnect from the basic service set (BSS) network if the miniport driver is operating in ExtSTA mode and the 802.11 station is connected to the BSS network. If the 802.11 station connected to an infrastructure BSS, it must send an 802.11 Disassociation frame.
When the 802.11 disconnects from the BSS, the miniport driver must make a media-specific NDIS_STATUS_DOT11_DISASSOCIATION indication. The uSource member of the DOT11_DISASSOCIATION_PARAMETERS structure must be set to DOT11_DISASSOC_SOURCE_OS.

Note

The miniport driver must make the NDIS_STATUS_DOT11_DISASSOCIATION indication before it finishes the method request of DOT11_RESET_REQUEST.

Cancel any scan operation that the 802.11 station is performing
If the 802.11 station is performing an explicit scan operation initiated through a set request of OID_DOT11_SCAN_REQUEST, the miniport driver must make the NDIS_STATUS_DOT11_SCAN_CONFIRM indication before it finishes the method request of DOT11_RESET_REQUEST.
Clear its transmit and receive queues. If transmit packets are pending, the miniport driver must call NdisMSendNetBufferListsComplete for each packet in the transmit queue. When it calls NdisMSendNetBufferListsComplete, the miniport driver must set the Status member of each NET_BUFFER_LIST structure that is specified by the NetBufferLists parameter to NDIS_STATUS_RESET_IN_PROGRESS.
Keep the current power state of the 802.11 station as specified through the Native 802.11 Operational msDot11NICPowerState MIB object. For more information about this MIB object, see OID_DOT11_NIC_POWER_STATE.
Transition to the INIT state of the current operation mode

When the method request of OID_DOT11_RESET_REQUEST is made and the miniport driver is operating in the Extensible Station (ExtSTA) mode, the miniport driver must:

Clear the PMKID cache that was previously set through OID_DOT11_PMKID_LIST. The miniport driver must set the PMKID list to its default value of an empty list.
Clear the privacy exemption list that was previously set through OID_DOT11_PRIVACY_EXEMPTION_LIST. The miniport driver must set the privacy exemption list to its default value of an empty list.
Discard all cipher keys
If the miniport driver is operating in Extensible Station (ExtSTA) mode, these keys were previously set through OID_DOT11_CIPHER_DEFAULT_KEY or OID_DOT11_CIPHER_KEY_MAPPING_KEY.
Set the members of its DOT11_STATISTICS structure to zero. For more information about this structure, see OID_DOT11_STATISTICS.
If the miniport driver previously made a media-specific indication of NDIS_STATUS_DOT11_CONNECTION_START but did not make the NDIS_STATUS_DOT11_CONNECTION_COMPLETION indication, make the completion indication before it finishes the method request of DOT11_RESET_REQUEST.
If the miniport driver previously made a media-specific indication of NDIS_STATUS_DOT11_ASSOCIATION_START but did not make the NDIS_STATUS_DOT11_CONNECTION_COMPLETION indication, make the completion indication before it finishes the method request of DOT11_RESET_REQUEST.
If the miniport driver previously made a media-specific indication of NDIS_STATUS_DOT11_ROAMING_START but did not make the NDIS_STATUS_DOT11_ROAMING_COMPLETION indication, make the completion indication before it finishes the method request of DOT11_RESET_REQUEST.

When resetting the MAC layer, the 802.11 station must set the following MIB objects to their default values if bSetDefaultMIB is set to TRUE

All standard 802.11 MIB objects associated with the MAC layer. For more information about these MIB objects, see Native 802.11 MIB OIDs.
All ExtSTA MIB objects associated with the MAC layer. For more information about these MIB objects, see Native 802.11 Extensible Station OIDs.
The miniport driver resets these MIB objects to their default values only if the driver is operating in ExtSTA mode.
All Native 802.11 Operational MIB objects associated with the MAC layer. For more information about these MIB objects, see Native 802.11 Operational OIDs.

The 802.11 station must do the following when it resets the PHY layer:

Reset all supported PHY types
If bSetDefaultMIB is set to TRUE, set the standard 802.11 MIB objects for the PHY layer to the default values. The station must set the MIB objects pertaining to all the supported PHY types to their default values.

When the reset operation is complete, the miniport driver must return a DOT11_STATUS_INDICATION structure to confirm the reset operation. The miniport driver does this by:

Formatting the InformationBuffer member of the OidRequest parameter as a DOT11_STATUS_INDICATION structure.
The miniport driver sets the uStatusType member of the DOT11_STATUS_INDICATION structure to NDIS_STATUS_DOT11_RESET_CONFIRM.
The miniport driver sets the ndisStatus member of the DOT11_STATUS_INDICATION structure to NDIS_STATUS_SUCCESS if the reset operation completed successfully. If the reset operation failed, the miniport driver sets this member to the appropriate NDIS_STATUS value.
Setting the value of the BytesRead member of the OidRequest parameter to the size of the DOT11_RESET_REQUEST structure.

Note

The miniport driver must not set the value of the BytesWritten member of the OidRequest parameter.

Requirements

Header

windot11.h

OID_DOT11_RESET_REQUEST (Compact 2013)

Requirements

See Also

Reference

Additional resources