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.