OID_DOT11_HARDWARE_PHY_STATE (Compact 2013)
3/26/2014
When queried, the OID_DOT11_HARDWARE_PHY_STATE object identifier (OID) requests that the miniport driver return the value of the Extensible Station (ExtSTA) msDot11HardwarePHYState management information base (MIB) object.
The msDot11HardwarePHYState MIB object defines the power state of the current PHY type on the 802.11 station.
The data type for OID_DOT11_HARDWARE_PHY_STATE is a BOOLEAN value. A value of TRUE indicates that the PHY is turned on.
Some 802.11 network adapeters support a hardware setting on the computer for turning the PHY on or off. The OID_DOT11_HARDWARE_PHY_STATE OID queries power state of the current PHY type based on the hardware setting.
When OID_DOT11_HARDWARE_PHY_STATE is queried, the miniport driver must set the returned BOOLEAN value as follows:
If the network adapter does support a hardware setting, the value must be FALSE (if the PHY is turned off) or TRUE (if the PHY is turned on).
If the network adapter does not support a hardware setting, the value must be TRUE.
Software settings for the PHY power state are made through the Native 802.11 Operational msDot11NICPowerState MIB variable. For more information about this MIB variable, see OID_DOT11_NIC_POWER_STATE.
The 802.11 station must set the PHY’s power state based on the msDot11NICPowerState and msDot11HardwarePHYState MIB variables in the following way:
msDot11NICPowerState Value |
msDot11HardwarePHYState Value |
PHY Power State |
|---|---|---|
TRUE |
TRUE |
Turned ON |
FALSE |
TRUE |
Turned OFF |
TRUE |
FALSE |
Turned OFF |
FALSE |
FALSE |
Turned OFF |
The current PHY type is determined through the ExtSTA msDot11CurrentPhyID MIB object. This MIB object specifies the index (ID) of the current PHY type within the 802.11 station’s list of supported PHY types. For more information about this MIB object, see OID_DOT11_CURRENT_PHY_ID.
The miniport driver must make a NDIS_STATUS_DOT11_PHY_STATE_CHANGED indication whenever the value of the msDot11HardwarePHYState MIB object changes.
Requirements
Header |
windot11.h |
See Also
Reference
Native 802.11 Extensible Station OIDs
OID_DOT11_NIC_POWER_STATE
OID_DOT11_CURRENT_PHY_ID
NDIS_STATUS_DOT11_PHY_STATE_CHANGED
Native 802.11 Wireless LAN OIDs