Radio State Indications
Collapse the table of content
Expand the table of content
The document is archived and information here might be outdated

Radio State Indications

The 802.11 miniport driver makes a radio state indication when any of the following occur:

  • The driver's MiniportSetInformation function is called with the Oid parameter set to an IHV-defined value used to change the radio state.

  • The driver services an IHV-defined IOCTL that changes the radio state. This can only happen if the driver creates a stand-alone device object through NdisMRegisterDevice.

  • A hardware switch setting that affects the radio state is changed on the device.

When making the radio state indication, the StatusBufferparameter of NdisMIndicateStatuspoints to a driver-allocated buffer that contains the following structures:


NDIS_802_11_STATUS_TYPE  StatusType;
NDIS_802_11_RADIO_STATE  RadioState;

The driver sets the data in this buffer as follows:

  • The StatusType member is set to Ndis802_11StatusType_RadioState.

  • The RadioState member is set to the current radio state.

The NDIS_802_11_RADIO_STATE enumeration defines the following radio states:

Ndis802_11RadioStatusOn

The radio is powered on.

Ndis802_11RadioStatusHardwareOff

The radio is powered off through a hardware setting. For example, some 802.11 NICs support a switch on the computer for powering the radio on or off.

Ndis802_11RadioStatusSoftwareOff

The radio is powered off through a software setting due to one of the following software actions:

  • The driver's MiniportSetInformation function is called with the Oid parameter set to an IHV-defined value used to change the radio state.

  • The driver services an IHV-defined IOCTL that changes the radio state. This can only happen if the driver creates a stand-alone device object through NdisMRegisterDevice.

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft