OID_DOT11_MAX_DWELL_TIME
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 queried, the OID_DOT11_MAX_DWELL_TIME object identifier (OID) requests that the miniport driver return the value of the IEEE 802.11 dot11MaxDwellTime management information base (MIB) object for the current PHY type on the 802.11 station.
The dot11MaxDwellTime MIB object defines the maximum time that the current PHY type operates on a single channel when the 802.11 station is transmitting data.
Note Support for OID_DOT11_MAX_DWELL_TIME is mandatory if the NIC supports the dot11_phy_type_fhss PHY type. For more information about how the miniport driver specifies its list of supported PHY types, see OID_DOT11_SUPPORTED_PHY_TYPES.
The data type for OID_DOT11_MAX_DWELL_TIME is a ULONG value that specifies the maximum dwell time in units of 802.11 time units (TU). One TU is 1024 microseconds. The value of the dot11MaxDwellTime MIB must be from 1 through 65535.
The dot11MaxDwellTime MIB object is valid for only the frequency-hopping spread spectrum (FHSS) PHY type. If the current PHY type is not set to dot11_phy_type_fhss, the miniport driver must fail the query request by returning NDIS_STATUS_INVALID_DATA from its MiniportOidRequest function.
If the miniport driver is operating in Extensible Station (ExtSTA) mode, the current PHY type is determined through the ExtSTA msDot11CurrentPhyID MIB object. This MIB object specifies the index of the current PHY type within the 802.11 station's list of supported PHY types. For more information about msDot11CurrentPhyID, see OID_DOT11_CURRENT_PHY_ID.
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 Wireless LAN OIDs