OID_DOT11_POWER_MGMT_REQUEST (Compact 2013)
3/26/2014
When set, the OID_DOT11_POWER_MGMT_REQUEST object identifier (OID) requests that the miniport driver set its Extensible Station (ExtSTA) msDot11PowerSavingLevel management information base (MIB) object to the specified data.
When queried, this OID requests that the miniport driver return the value of the msDot11PowerSavingLevel MIB object.
The msDot11PowerSavingLevel MIB object specifies the power management mode of the 802.11 station.
The data type for OID_DOT11_POWER_MGMT_REQUEST is a ULONG value, which specifies the level of power-saving activity performed by the 802.11 station.
The following power-saving levels are defined:
- DOT11_POWER_SAVING_NO_POWER_SAVING
Specifies no power-saving activity performed by the 802.11 station
- DOT11_POWER_SAVING_FAST_PSP
Specifies a power save polling (PSP) mode that uses the fastest power-saving mode. This power mode must provide the best combination of network performance and power usage.
- DOT11_POWER_SAVING_MAX_PSP
Specifies a PSP mode that uses the maximum (MAX) power saving capabilities. The MAX power save mode results in the greatest power savings for the radio on the 802.11 station.
- DOT11_POWER_SAVING_MAXIMUM_LEVEL
Specifies a proprietary PSP mode implemented by the independent hardware vendor (IHV) that exceeds the DOT11_POWER_SAVING_MAX_PSP power-saving level.
The 802.11 station is required to support power-saving levels of DOT11_POWER_SAVING_FAST_PSP and DOT11_POWER_SAVING_MAX_PSP.
After the power-saving levels are changed to any value except DOT11_POWER_SAVING_NO_POWER_SAVING, the 802.11 station must do the following:
- If the 802.11 station is connected to a basic service set (BSS) network:
- If its transmit queue is not empty, announce its power management mode in the next packet it transmits. It does this by setting the Power Management subfield of the Frame Control field in the 802.11 MAC header of the transmitted frame.
For more information about the Power Management subfield, refer to Clause 7.1.3.1.7 of the IEEE 802.11‑1999 standard. - If its transmit queue is empty, announce its power mode by creating and transmitting a frame that contains only the 802.11 MAC header.
- After entering a power-save state, perform the power management procedures defined in Clause 11.2 of the IEEE 802.11-1999 standard.
- If its transmit queue is not empty, announce its power management mode in the next packet it transmits. It does this by setting the Power Management subfield of the Frame Control field in the 802.11 MAC header of the transmitted frame.
- If the 802.11 station is not connected to a BSS network:
- If the radio is turned on and the Native 802.11 Operational msDot11NICPowerState management information base (MIB) object is set to TRUE, turn off the radio and only turn on the radio when performing scan operations.
For more information about the msDot11NICPowerState MIB object, see OID_DOT11_NIC_POWER_STATE.
For more information about scan operations, see OID_DOT11_SCAN_REQUEST. - Keep the current value of the msDot11NICPowerState MIB object whenever the 802.11 station turns the radio off or on.
- When the radio is turned off or on, the miniport driver must not make a NDIS_STATUS_DOT11_PHY_STATE_CHANGED indication.
- If the radio is turned on and the Native 802.11 Operational msDot11NICPowerState management information base (MIB) object is set to TRUE, turn off the radio and only turn on the radio when performing scan operations.
The miniport driver must not change the power state of the 802.11 station when the driver’s MiniportPnPEventNotify function is called for the NdisDevicePnPEventPowerProfileChanged event. The miniport driver must ignore this event and change the 802.11 station’s power state only when OID_DOT11_POWER_MGMT_REQUEST is set.
Requirements
Header |
windot11.h |
See Also
Reference
Native 802.11 Extensible Station OIDs
OID_DOT11_NIC_POWER_STATE
OID_DOT11_SCAN_REQUEST
NDIS_STATUS_DOT11_PHY_STATE_CHANGED
Native 802.11 Wireless LAN OIDs