Share via

NDIS_STATUS_DOT11_PHY_STATE_CHANGED

  • Article

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.

 

A miniport driver must make the NDIS_STATUS_DOT11_PHY_STATE_CHANGED indication whenever the hardware or software power state of a PHY changes on the 802.11 station.

The data type for this indication is the DOT11_PHY_STATE_PARAMETERS structure:

    typedef struct DOT11_PHY_STATE_PARAMETERS {
         NDIS_OBJECT_HEADER Header;
         ULONG uPhyId;
         BOOLEAN bHardwarePhyState;
         BOOLEAN bSoftwarePhyState;
    } DOT11_PHY_STATE_PARAMETERS,   *PDOT11_PHY_STATE_PARAMETERS;

The DOT11_PHY_STATE_PARAMETERS structure contains the following members:

Header
The type, revision, and size of the DOT11_PHY_STATE_PARAMETERS structure. This member is formatted as an NDIS_OBJECT_HEADER structure.

The miniport driver must set the members of Header to the following values:

Type
This member must be set to NDIS_OBJECT_TYPE_DEFAULT.

Revision
This member must be set to DOT11_PHY_STATE_PARAMETERS_REVISION_1.

Size
This member must be set to sizeof(DOT11_PHY_STATE_PARAMETERS).

For more information about these members, see NDIS_OBJECT_HEADER.

uPhyId
The PHY identifier (ID) of the PHY whose state has changed.

The PHY ID is an index into the table of supported PHYs that are specified by the Native 802.11 Operational msDot11SupportedPhyTypes MIB object. For more information about PHY IDs and the msDot11SupportedPhyTypes MIB object, see OID_DOT11_SUPPORTED_PHY_TYPES.

If the uPhyId member is set to DOT11_PHY_ID_ANY, the NDIS_STATUS_DOT11_PHY_STATE_CHANGED indication applies to all PHYs in the msDot11SupportedPhyTypes MIB object.

bHardwarePhyState
A Boolean value that specifies the hardware power state of the PHY that is referenced by uPhyId. If TRUE, the hardware power state is enabled. If FALSE, the hardware power state is disabled.

For more information about the PHY's hardware power state, see OID_DOT11_HARDWARE_PHY_STATE.

bSoftwarePhyState
A Boolean value that specifies the software power state of the PHY that is referenced by uPhyId. If TRUE, the software power state is enabled. If FALSE, the software power state is disabled.

For more information about the PHY's software power state, see OID_DOT11_NIC_POWER_STATE.

The miniport driver calls NdisMIndicateStatusEx to make an NDIS_STATUS_DOT11_PHY_STATE_CHANGED indication, and must pass a pointer to an NDIS_STATUS_INDICATION structure through the StatusIndication parameter. When making this indication, the driver must set the following members of the NDIS_STATUS_INDICATION structure:

  • StatusCode must be set to NDIS_STATUS_DOT11_PHY_STATE_CHANGED.

  • StatusBuffer must be set to the address of a DOT11_PHY_STATE_PARAMETERS structure.

  • StatusBufferSize must be set to sizeof(DOT11_PHY_STATE_PARAMETERS).

Requirements

Version

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

Header

 Windot11.h (include Ndis.h)