OID_DOT11_SCAN_REQUEST
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.
When set, the OID_DOT11_SCAN_REQUEST object identifier (OID) requests that the 802.11 station perform a survey of all basic service set (BSS) networks within range of the NIC's radio. The 802.11 station performs the scan operation by using the parameters defined in the set request.
The data type for this OID is the DOT11_SCAN_REQUEST_V2 structure.
When OID_DOT11_SCAN_REQUEST is set, the miniport driver must fail the set request under the following conditions by returning the specified value from its MiniportOidRequest function.
Condition | Return value |
---|---|
The uNumOfdot11SSIDs member of the [DOT11_SCAN_REQUEST_V2](https://msdn.microsoft.com/library/windows/hardware/ff548767) structure has a value greater than the value of uScanSSIDListSize that the driver previously returned through a query of [OID_DOT11_EXTSTA_CAPABILITY](oid-dot11-extsta-capability.md).
Note This condition is applicable only when the miniport driver is operating in Extensible Station (ExtSTA) mode.
|
NDIS_STATUS_INVALID_LENGTH |
The ChDescriptionType member of the [DOT11_SCAN_REQUEST_V2](https://msdn.microsoft.com/library/windows/hardware/ff548767) structure contains an invalid enumerator value. |
NDIS_STATUS_BAD_VERSION |
The dot11PhyType member of the [DOT11_PHY_TYPE_INFO](https://msdn.microsoft.com/library/windows/hardware/ff548745) structure specifies a PHY type that is not supported by the 802.11 station. |
NDIS_STATUS_BAD_VERSION |
The dot11PhyId member of the [DOT11_PHY_TYPE_INFO](https://msdn.microsoft.com/library/windows/hardware/ff548745) structure is set to a value of DOT11_PHY_ID_ANY. |
NDIS_STATUS_INVALID_DATA |
The dot11PhyId member of the [DOT11_PHY_TYPE_INFO](https://msdn.microsoft.com/library/windows/hardware/ff548745) structure is set to a value that is larger than the number of entries in the list of supported PHYs returned by the driver through a query of [OID_DOT11_SUPPORTED_PHY_TYPES](oid-dot11-supported-phy-types.md). |
NDIS_STATUS_BAD_VERSION |
A scan initiated from a previous set of OID_DOT11_SCAN_REQUEST is not complete. |
NDIS_STATUS_DOT11_MEDIA_IN_USE |
The msDot11NICPowerState management information base (MIB) object is set to FALSE. For more information about this MIB object, see [OID_DOT11_NIC_POWER_STATE](oid-dot11-nic-power-state.md). |
NDIS_STATUS_POWER_STATE_INVALID |
All of the PHYs in the list of PHY types are turned off through a hardware switch setting or proprietary software setting. |
NDIS_STATUS_DOT11_POWER_STATE_INVALID |
One or more of the PHYs in the list of PHY types are either not supported or have been disabled on the 802.11 station through a proprietary mechanism implemented by the independent hardware vendor (IHV). This condition does not apply to PHYs disabled through a set request of [OID_DOT11_NIC_POWER_STATE](oid-dot11-nic-power-state.md). |
NDIS_STATUS_UNSUPPORTED_MEDIA |
The list of PHY types includes a type that is not supported by the 802.11 station or contains a channel description that is not supported by the regulatory domain in which the station is operating. |
NDIS_STATUS_BAD_VERSION |
When performing the scan operation, the miniport driver and 802.11 station must follow the guidelines described in Native 802.11 Scan Operations. The miniport driver must not wait for the scan operation to finish before completing the set request. The driver must return NDIS_STATUS_SUCCESS from its MiniportOidRequest function after initiating the scan operation.
If the miniport driver supports the functionality of multiple MAC entities through virtualization, the driver should not return NDIS_STATUS_DOT11_MEDIA_IN_USE if the medium is blocked by another MAC.
Version |
Available in Windows Vista and later versions of the Windows operating systems. |
Header |
Windot11.h (include Ndis.h) |
Native 802.11 Wireless LAN OIDs