Compartilhar via


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.

Requirements

Version

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

Header

Windot11.h (include Ndis.h)

See also

Native 802.11 Wireless LAN OIDs