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 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:
Note This is the default value for the msDot11PowerSavingLevel MIB object.
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.
Note When the miniport driver receives an OID_DOT11_RESET_REQUEST method request the miniport driver must reset the msDot11PowerSavingLevel MIB object to its default value under the following conditions:
- When MIB values for the MAC and/or PHY are reset to their default values only if bSetDefaultMIB is set to TRUE.
- When MAC or PHY values are affected by the value of the dot11ResetType member.
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 220.127.116.11.7 of the IEEE 802.11-2012 standard.
If its transmit queue is empty, announce its power mode by creating and transmitting a frame containing only the 802.11 MAC header.
After entering a power-save state, perform the power management procedures defined in Clause 10.2 of the IEEE 802.11-2012 standard.
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.
Retain 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 an NDIS_STATUS_DOT11_PHY_STATE_CHANGED indication.
The miniport driver must not change the power state of the 802.11 station when the driver's MiniportDevicePnPEventNotify function is called for the NdisDevicePnPEventPowerProfileChanged event. The miniport driver must ignore this event and only make changes to the 802.11 station's power state when OID_DOT11_POWER_MGMT_REQUEST is set.
Starting with Windows 7, if the wireless adapter is set to a Medium Power Saving setting, the operating system enables DOT11_POWER_SAVING_MAX_PSP on the 802.11 station if one of the following is true:
The wireless adapter is not associated with an infrastructure network.
The wireless adapter is associated with an infrastructure network and the associated AP supports the Automatic Power Save Delivery (APSD) - Power Save mode.
Note Medium Power Saving is the default Power Saving Mode behavior when the computer is in the Balanced power plan. These adapter settings are accessed through the Power Options control panel.
Starting with Windows 8, supporting Wi-Fi Direct requires that this OID is used to configure power level for all Wi-Fi Direct ports. The port availability period and power saving features are adapted to the power level requested.
When the power-saving level is set to DOT11_POWER_SAVING_NO_POWER_SAVING the miniport should disable all power saving mechanisms on the WFD port, and provide the specific port maximum access to the radio.
Available in Windows Vista and later versions of the Windows operating systems.
|Windot11.h (include Ndis.h)|