NDIS_STATUS_DOT11_STOP_AP

  • 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 an NDIS_STATUS_DOT11_STOP_AP status indication when the NIC cannot sustain 802.11 access point (AP) functionality on any of the available PHYs. The driver should send this indication only after the NIC has stopped any APs that are operating on the available PHYs.

The data type for this indication is the DOT11_STOP_AP_PARAMETERS structure.

While the NIC is in the Extensible Station AP (ExtAP) mode, it could determine that it can no longer operate the AP on the current PHY. For example, if a PHY is operating in orthogonal frequency division multiplexing (OFDM) mode, radar signals might interfere with how the PHY changes frequency.

If, because of these or similar circumstances, the NIC determines that it must stop AP operations, the miniport driver should perform the following operations:

  • Disassociate all peer stations from the AP.

  • Drop all pending frames.

  • Send all appropriate NDIS status indications to the operating system, which includes NDIS_STATUS_DOT11_STOP_AP.

After the miniport driver has performed these actions, it must send an NDIS_STATUS_DOT11_CAN_SUSTAIN_AP status indication to indicate that it is ready to receive an OID_DOT11_START_AP_REQUEST request to start the AP again.

If the miniport driver receives an OID_DOT11_START_AP_REQUEST set request after it has indicated NDIS_STATUS_DOT11_STOP_AP but before it has indicated NDIS_STATUS_DOT11_CAN_SUSTAIN_AP, the driver should fail the OID request with a failure code of NDIS_STATUS_INVALID_STATE.

The miniport driver calls NdisMIndicateStatusEx to make an NDIS_STATUS_DOT11_STOP_AP indication, and must pass a pointer to an NDIS_STATUS_INDICATION structure by using the StatusIndication parameter. When the driver makes this indication, it must set the following members of the NDIS_STATUS_INDICATION structure:

  • StatusCode must be set to NDIS_STATUS_DOT11_STOP_AP.

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

  • StatusBufferSize must be set to sizeof(DOT11_STOP_AP_PARAMETERS).

Requirements

Version

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

Header

 Windot11.h (include Ndis.h)

See also

DOT11_STOP_AP_PARAMETERS

NDIS_STATUS_INDICATION

NdisMIndicateStatusEx

OID_DOT11_START_AP_REQUEST