OID_DOT11_NIC_POWER_STATE (Compact 2013)

Article
07/31/2017

3/26/2014

When set, this OID requests that the miniport driver set the Native 802.11 Operational msDot11NICPowerState management information base (MIB) object to the specified value.

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

The msDot11NICPowerState MIB object specifies the power state of the current PHY type on the 802.11 station.

The miniport driver must keep the value of the msDot11NICPowerState MIB object through any of the following:

Resets of the 802.11 station through a method request of OID_DOT11_RESET_REQUEST
Resets of the miniport driver through a call to the driver’s MiniportResetEx function.
Calls to the miniport driver’s MiniportHaltEx or MiniportShutdownEx function. The driver must restore the value of the msDot11NICPowerState MIB object and the power state of the current PHY type whenever the driver’s MiniportInitializeEx function is called.

The data type for this OID is a BOOLEAN value. A value of TRUE indicates that the PHY is turned on.

After OID_DOT11_NIC_POWER_STATE is set, the 802.11 station must do the following:

If the 802.11 station is performing an explicit scan operation that was initiated through a set of OID_DOT11_SCAN_REQUEST, fail the set request by returning NDIS_STATUS_MEDIA_IN_USE from its MiniportOidRequest function.
After all PHYs that use the radio are turned off, turn off the radio

The following points apply to a miniport driver 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 this MIB object, see OID_DOT11_CURRENT_PHY_ID.
If the value of the msDot11NICPowerState MIB object is changed when OID_DOT11_NIC_POWER_STATE is set, the miniport driver must make a NDIS_STATUS_DOT11_PHY_STATE_CHANGED indication. The miniport driver must also make this indication if the value of the msDot11NICPowerState MIB object is changed through a proprietary interface or OID implemented by the independent hardware vendor (IHV).
Some 802.11 network adapters support a hardware setting on the computer for turning the PHY on or off. The ExtSTA msDot11HardwarePHYState MIB variable specifies the current hardware setting for the PHY. The 802.11 station must set the PHY’s power state based on the msDot11NICPowerState and msDot11HardwarePHYState MIB variables. For more information about the msDot11HardwarePHYState MIB variable, see NDIS_STATUS_DOT11_PHY_STATE_CHANGED.

If the value of the msDot11NICPowerState MIB object has not been previously set, the miniport driver must use a default value of TRUE for this MIB object.

Requirements

Header

windot11.h

OID_DOT11_NIC_POWER_STATE (Compact 2013)

Requirements

See Also

Reference

Additional resources