OID_DOT11_SAFE_MODE_HT_ENABLED

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 set, the OID_DOT11_SAFE_MODE_HT_ENABLED object identifier (OID) requests that the miniport driver enable 802.11n safe mode on the 802.11 station by setting the Boolean value msDot11SafeModeHtEnabled to TRUE.

The data type for this OID is a Boolean value.

The miniport driver must fail a set request with error code NDIS_STATUS_INVALID_STATE if the 802.11 station is in any state except the initialization (INIT) state.

When this OID is queried, if the extensible station is in the INIT state, the miniport driver must complete the request if the NIC set the bSafeModeImplemented member of the DOT11_EXTSTA_ATTRIBUTES structure to TRUE. Otherwise, the miniport driver should fail the set request.

This OID is set only if the NIC implements the 802.11n safe mode of operation, as indicated by the value of the bSafeModeImplemented member of DOT11_EXTSTA_ATTRIBUTES.

If this OID is not set, its default value is used.

Safe mode is disabled by default. The default value of msDot11SafeModeHtEnabled is FALSE.

When queried, OID_DOT11_SAFE_MODE_HT_ENABLED requests that the miniport driver return the value of msDot11SafeModeHtEnabled.

When in safe mode, the miniport driver should ignore dot11ExcludeUnencrypted.

The NIC must not use traffic specification (TSPEC) in safe mode.

When processing an OID_DOT11_SAFE_MODE_HT_ENABLED OID request, the miniport should do the following:

  • Indicate that QoS is in use on the network by setting the ucActiveQoSProtocol member of the DOT11_ASSOCIATION_COMPLETION_PARAMETERS structure to one of the flag values listed in the ucActiveQoSProtocolmember description.
  • In the case of an 802.11g association, the miniport should not use QoS. The ucActiveQoSProtocol member of DOT11_ASSOCIATION_COMPLETION_PARAMETERS should be set to zero on association completion.
  • On the TX path, the miniport should extend the 802.11 header with QoS priority-received in-frame OOB data, based on the condition that WMM was negotiated on the current association.
  • On the RX path, the miniport should not strip the QoS flag from the 802.11 header when operating in safe mode.
  • Pass the QoS data in the 802.11 frame as-is to the Nwifi driver.
  • Disable 802.11w when in Federal Information Processing Standards (FIPS) mode. Otherwise, Windows would not succeed the association.
  • While it is transmitting RSN capabilities, the miniport should ensure that the SPP (signaling and payload protected) A-MSDU capable bit (Bit 10) is set to zero. Only PP (payload protected) A-MSDU is supported in safe mode.

Note  The miniport will not receive OID_DOT11_SAFE_MODE_ENABLED if it completes OID_DOT11_SAFE_MODE_HT_ENABLED successfully.

 

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2012 R2

Header

Windot11.h (include Ndis.h)

See also

DOT11_EXTSTA_ATTRIBUTES

OID_DOT11_SAFE_MODE_ENABLED

Native 802.11 Wireless LAN OIDs