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. .gif "Ee484896.note(en-us,WinEmbedded.80).gif") 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