OID_DOT11_RTS_THRESHOLD

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_RTS_THRESHOLD object identifier (OID) requests that the miniport driver set the IEEE 802.11 dot11RTSThreshold management information base (MIB) object to the specified value.

When queried, this OID requests that the miniport driver return the value of the dot11RTSThreshold MIB object.

The dot11RTSThreshold MIB object specifies the maximum length that a MAC protocol data unit (MPDU) frame can have before the 802.11 station initiates the 802.11 request to send (RTS)/clear to send (CTS) handshake. For more information about the RTS/CTS handshake and RTS threshold, refer to Clause 9.3 of the IEEE 802.11-2012 standard.

The data type for OID_DOT11_RTS_THRESHOLD is a ULONG value that specifies the RTS threshold in bytes.

The value of the dot11RTSThreshold MIB object must be from 0 through 2347.

When OID_DOT11_RTS_THRESHOLD is set, the following actions apply to the 802.11 station:

  • The 802.11 station must use the new RTS threshold value on all MAC service data unit (MSDU) packets passed after the set request by the operating system to the miniport driver's MiniportSendNetBufferLists function.

  • The 802.11 station can use the new RTS threshold value on all MSDU packets that are pending in the station's transmit queue. Alternatively, the 802.11 station can continue to use the old RTS threshold value for the pending MSDU packets.

  • The 802.11 station must not use the new RTS threshold value for any MPDU frames of the MSDU packet that the station is transmitting when OID_DOT11_RTS_THRESHOLD is set.

The default value for the dot11RTSThreshold MIB object is 2347. The miniport driver must set this MIB object to its default when one of the following occurs:

  • The miniport driver's MiniportInitializeEx function is called.

  • A method request of OID_DOT11_RESET_REQUEST is made to reset the MAC layer of the 802.11 station and the bSetDefaultMIB member of the DOT11_RESET_REQUEST structure is TRUE.

Note  A Native 802.11 miniport driver that is designed to run on the Windows Vista or Windows Server 2008 operating systems must always reset this 802.11 MIB OID to its default value. This is the case regardless of the value of the bSetDefaultMIB member of the DOT11_RESET_REQUEST structure. This requirement applies to a miniport driver that, in a call to the NdisMSetMiniportAttributes function, sets MiniportAttributes -> Native_802_11_Attributes -> Header -> Revision to NDIS_MINIPORT_ADAPTER_802_11_ATTRIBUTES_REVISION_1.

 

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

Windot11.h (include Ndis.h)

See also

Native 802.11 MIB OIDs

Native 802.11 Wireless LAN OIDs