OID_DOT11_RESET_REQUEST

Articolo
08/08/2017

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 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.

    typedef struct _DOT11_RESET_REQUEST {
         DOT11_RESET_TYPE dot11ResetType;
         DOT11_MAC_ADDRESS dot11MacAddress;
         BOOLEAN bSetDefaultMIB;
    } DOT11_RESET_REQUEST, *PDOT11_RESET_REQUEST;

This structure includes the following members:

dot11ResetType
The IEEE layer to be reset on the 802.11 station. The data type for this member is the DOT11_RESET_TYPE enumeration:

dot11_reset_type_phy
Only the PHY layer is reset.

dot11_reset_type_mac
Only the MAC layer is reset.

dot11_reset_type_phy_and_mac
Both the PHY and MAC layers are reset.

Note A miniport driver operating in Extensible Station (ExtSTA) mode must only support the reset type of dot11_reset_type_phy_and_mac. In this situation, the driver must reset the MAC and all PHY layers supported on the 802.11 station.

dot11MacAddress
The unicast media access control (MAC) address used by the 802.11 station following the reset. This member can be used to configure a locally administered MAC address on the 802.11 station.

The miniport driver must not ignore this member if dot11ResetType is set to dot11_reset_type_mac or dot11_reset_type_phy_and_mac.

bSetDefaultMIB
The 802.11 station resets the specified IEEE layers and resets the 802.11 management information base (MIB) objects of the IEEE layer to their default values. The default values are mostly defined by the miniport implementation. However, some Native 802.11 MIB objects have explicit default values defined, such as OID_DOT11_RTS_THRESHOLD and OID_DOT11_SHORT_RETRY_LIMIT. For more information about the default values for the Native 802.11 MIB objects, see IEEE 802.11 MIB Objects.

The Native 802.11 miniport driver must follow these guidelines when it resets the 802.11 MIB objects to their default values:

In a call to the NdisMSetMiniportAttributes function, if the Native 802.11 miniport driver sets MiniportAttributes-> Native_802_11_Attributes-> Header-> Revision to NDIS_MINIPORT_ADAPTER_802_11_ATTRIBUTES_REVISION_1, the driver must always reset the 802.11 MIB objects to their default value regardless of the value of the bSetDefaultMIB member.
In a call to the NdisMSetMiniportAttributes function, if the Native 802.11 miniport driver sets MiniportAttributes-> Native_802_11_Attributes-> Header-> Revision to a higher revision number, the driver should reset the 802.11 MIB objects to their default value only when the value of the bSetDefaultMIB member is set to TRUE.

If this member is FALSE, the 802.11 station resets the specified IEEE layers but retains the current values of the 802.11 MIB objects.

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 situation, 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 completes 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 completes the method request of DOT11_RESET_REQUEST.
Cancel any scan operation 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 completes 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.
Retain 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.

For more information about the operation modes of a Native 802.11 miniport driver, see Native 802.11 Operation Modes.

For more information about the operating states of a Native 802.11 miniport driver, see Native 802.11 Operating States.

The miniport driver can also choose to re-initialize data that is specific to the Extensible AP (ExtAP) operating mode, such as beacon data and cached information elements (IEs).

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 do the following:

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 completes 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_ASSOCIATION_COMPLETION indication, make the completion indication before it completes 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 completes 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 Native 802.11 MIB objects associated with the MAC layer. For more information about these MIB objects, see Native 802.11 MIB Objects.
All ExtSTA MIB objects associated with the MAC layer. For more information about these MIB objects, see Extensible Station MIB Objects.

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

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 of 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 DOT11_STATUS_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.

Starting with Windows 8, the Wi-Fi Direct port must reset the specified layers of the 802.11 state and all the Wi-Fi Direct state programmed on it whenever an OID_DOT11_RESET_REQUEST request is made. The miniport must transition to the initialization (INIT) state of the current operation mode. If it is operating as a Wi-Fi Direct Group Owner, it must stop the group and disconnect all its clients. If it is operating as a Wi-Fi Direct Client in a group, it must leave the group.

The Wi-Fi Direct state configured by the following OIDs must be reset to their default values whenever an OID_DOT11_RESET_REQUEST request is made:

Requirements

Version	Available in Windows Vista and later versions of the Windows operating systems.
Header	Windot11.h (include Ndis.h)

Condividi tramite

OID_DOT11_RESET_REQUEST

Requirements

See also

Risorse aggiuntive