Condividi tramite


OID_DOT11_NIC_POWER_STATE

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_NIC_POWER_STATE object identifier (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 retain the value of the msDot11NICPowerState MIB object through any of the following:

The data type for OID_DOT11_NIC_POWER_STATE is a BOOLEAN value. A value of TRUE indicates that the PHY is turned on. In response to a value of FALSE, the miniport driver can either turn off the radio only for the current PHY, or it can turn off the radios for all supported PHYs.

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 initiated through a set of OID_DOT11_SCAN_REQUEST, fail the set request by returning NDIS_STATUS_DOT11_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 an 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 NICs 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.

Note  If the miniport driver supports the functionality of multiple MAC entities through virtualization, the following requirements apply:

  • The msDot11NICPowerState MIB object applies to the same PHY on all such MAC entities.

  • If the operating system enables or disables a PHY through an OID set on one of the MAC entities, the driver should apply that change to the PHY on all virtualized MAC entities. The driver should then send appropriate NDIS_STATUS_DOT11_PHY_STATE_CHANGED indications for all MAC entities, both physical and virtual.

  • The driver should not return NDIS_STATUS_DOT11_MEDIA_IN_USE if the medium is blocked by another MAC.

 

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

Windot11.h (include Ndis.h)

See also

Native 802.11 Wireless LAN OIDs