When queried, the OID_DOT11_CURRENT_CCA_MODE object identifier (OID) requests that the miniport driver return the value of the IEEE 802.11 dot11CurrentCCAMode management information base (MIB) object for the current PHY type on the 802.11 station.
This MIB object specifies the current clear channel assessment (CCA) mode in use by the current PHY type. For more information about CCA, refer to Clause 184.108.40.206 of the IEEE 802.11-2012 standard and Clause 220.127.116.11 of the IEEE 802.11b-1999 standard.
The data type for OID_DOT11_CURRENT_CCA_MODE is a ULONG value.
The current CCA mode is explained in the following bitmask:
- DOT11_CCA_MODE_ED_ONLY (0x00000001)
CCA mode using the energy detect (ED) signal. For more information about the ED signal, refer to Clause 18.104.22.168 of the IEEE 802.11-2012 standard.
- DOT11_CCA_MODE_CS_ONLY (0x00000002)
CCA mode using the carrier sense (CS) signal. For more information about the CS signal, refer to Clause 22.214.171.124 of the IEEE 802.11-2012 standard.
- DOT11_CCA_MODE_ED_and_CS (0x00000004)
Both ED and CS modes.
- DOT11_HR_CCA_MODE_CS_WITH_TIMER (0x00000008)
CCA mode using the CS signal with a timer. For more information about this CCA mode, refer to Clause 126.96.36.199 of the IEEE 802.11b-1999 standard.
This mode is valid only for high-rate direct-sequence spread spectrum (HRDSSS) PHYs.
- DOT11_HR_CCA_MODE_HRCS_AND_ED (0x00000010)
Both ED and CS modes on high-rate (HR) PHYs. For more information about this CCA mode, refer to Clause 188.8.131.52 of the IEEE 802.11b-1999 standard.
This mode is valid only for HRDSSS PHYs.
The miniport driver must not set more than one bit when specifying the current CCA mode.
The dot11CurrentCCAMode MIB object is only valid for the following PHY types:
Direct-sequence spread spectrum (DSSS) PHY.
High-rate DSSS (HRDSSS) PHY.
Extended-rate PHY (ERP).
If the current PHY type is not set to dot11_phy_type_dsss, dot11_phy_type_hrdsss, or dot11_phy_type_erp, 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.
|Available in Windows Vista and later versions of the Windows operating systems.|