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:
© 2014 Microsoft