OID_DOT11_SCAN_REQUEST (Compact 2013)

3/26/2014

When set, this OID requests that the 802.11 station perform a survey of all basic service set (BSS) networks within range of the radio. The 802.11 station performs the scan operation by using the parameters that are 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 if the following conditions are true by returning the specified value from its MiniportOidRequest function.

Condition	Return Value
The uNumOfdot11SSIDs member of the DOT11_SCAN_REQUEST_V2 structure has a value greater than the value of uScanSSIDListSize that the driver previously returned through a query of OID_DOT11_EXTSTA_CAPABILITY. 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 structure contains an invalid enumerator value	NDIS_STATUS_BAD_VERSION
The dot11PhyType member of the DOT11_PHY_TYPE_INFO 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 structure is set to a value of DOT11_PHY_ID_ANY	NDIS_STATUS_INVALID_DATA
The dot11PhyId member of the DOT11_PHY_TYPE_INFO 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.	NDIS_STATUS_BAD_VERSION
A scan initiated from a previous set of OID_DOT11_SCAN_REQUEST is not completed	NDIS_STATUS_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.	NDIS_STATUS_POWER_STATE_INVALID
All 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 PHYs in the list of PHY types are not supported or have been disabled on the 802.11 station through a proprietary mechanism that was implemented by the independent hardware vendor (IHV). This condition does not apply to PHYs that are disabled through a set request of OID_DOT11_NIC_POWER_STATE.	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 it performs 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.

Requirements

Header

windot11.h

See Also

Reference

NDIS 5.x Legacy Wireless LAN OIDs
DOT11_SCAN_REQUEST_V2
MiniportOidRequest
OID_DOT11_EXTSTA_CAPABILITY
DOT11_PHY_TYPE_INFO
OID_DOT11_SUPPORTED_PHY_TYPES
NDIS 5.x Legacy Reference