DOT11_SCAN_REQUEST_V2 structure (windot11.h)
The DOT11_SCAN_REQUEST_V2 structure defines the parameters for the explicit scan operation performed by the 802.11 station. The station performs the explicit scan operation following an OID set request of OID_DOT11_SCAN_REQUEST.
Syntax
typedef struct _DOT11_SCAN_REQUEST_V2 {
DOT11_BSS_TYPE dot11BSSType;
DOT11_MAC_ADDRESS dot11BSSID;
DOT11_SCAN_TYPE dot11ScanType;
BOOLEAN bRestrictedScan;
ULONG udot11SSIDsOffset;
ULONG uNumOfdot11SSIDs;
BOOLEAN bUseRequestIE;
ULONG uRequestIDsOffset;
ULONG uNumOfRequestIDs;
ULONG uPhyTypeInfosOffset;
ULONG uNumOfPhyTypeInfos;
ULONG uIEsOffset;
ULONG uIEsLength;
UCHAR ucBuffer[1];
} DOT11_SCAN_REQUEST_V2, *PDOT11_SCAN_REQUEST_V2;
Members
dot11BSSType
The type of basic service set (BSS) networks for which the 802.11 station scans. The data type for this member is the DOT11_BSS_TYPE enumeration.
dot11BSSID
The BSS identifier (BSSID) of a BSS network for which the 802.11 station scans. If this member is set to the wildcard BSSID (0xFFFFFFFFFFFF), the station scans for all BSSIDs.
dot11ScanType
The type of scan that the 802.11 station performs. The data type for this member is the DOT11_SCAN_TYPE enumeration, which declares the following values:
dot11_scan_type_active
The station transmits an 802.11 Probe Request frame on each channel that it scans. It dwells on the channel long enough to receive 802.11 Probe Response frames for its Probe Request. The station also receives 802.11 Beacon frames sent on the channel.
dot11_scan_type_passive
The station does not transmit an 802.11 Probe Request frame on each channel that it scans. Instead, it receives 802.11 Beacon or Probe Request frames sent on the channel.
dot11_scan_type_auto
The station can perform active or passive scans, or it can use a combination of both scan types.
Regardless of the value of dot11ScanType, the 802.11 station must perform a scan type of dot11_scan_type_passive whenever it scans on channels that are not valid in the current regulatory domain. Also, the 802.11 station must perform a scan type of dot11_scan_type_passive if it does not have a default regulatory domain. For more information about regulatory domains, see OID_DOT11_CURRENT_REG_DOMAIN.
If the dot11_scan_type_forced bit is set in the dot11ScanType member, the 802.11 station must perform a complete scan on every supported channel. If the dot11_scan_type_forced bit is not set, the 802.11 station can perform a complete scan, or it can perform a partial scan on a subset of the supported channels.
bRestrictedScan
If this member is TRUE, the 802.11 station performs a scan restricted to the channel and PHY configuration used to connect to a BSS network.
The miniport driver must ignore this member if any of the following are true:
- The miniport driver is operating in ExtSTA mode.
- The 802.11 station is not connected to a BSS network.
udot11SSIDsOffset
The offset in the ucBuffer array where the service set identifier (SSID) list begins. Each entry in the SSID list is formatted as a DOT11_SSID structure.
The 802.11 station scans for each SSID in the list. For example, if dot11ScanType is set to dot11_scan_type_active, the 802.11 station transmits an 802.11 Probe Request for each SSID in the list while scanning on a channel.
uNumOfdot11SSIDs
The number of entries in the SSID list.
If uNumOfdot11SSIDs is zero, the miniport driver must use an SSID list containing the wildcard zero-length SSID.
bUseRequestIE
If this member is TRUE, the 802.11 station must include the list of request IDs (defined through the uRequestIDsOffset and uNumOfRequestIDs members) within the 802.11d request information element (IE) of each Probe Request frame that it transmits during the active scan.
The miniport driver must ignore this member (along with the uRequestIDsOffset and uNumOfRequestIDs members) if any of the following are true:
- The miniport driver is operating in ExtSTA mode.
- The 802.11 dot11MultiDomainCapabilityEnabled management information base (MIB) object is FALSE. For more information about the dot11MultiDomainCapabilityEnabled MIB object, see OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED.
- The dot11ScanType member is set to dot11_scan_type_passive.
uRequestIDsOffset
The offset in the ucBuffer array where the Request IDs list begins. Each entry in the request IDs list is formatted as a UCHAR data type.
uNumOfRequestIDs
The number of entries in the request IDs list.
uPhyTypeInfosOffset
The offset in the ucBuffer array where the list of PHY types begins. Each entry in the list of PHY types is formatted as a DOT11_PHY_TYPE_INFO structure.
The 802.11 station must perform the BSS scan by using each of the specified PHY types from this list.
The miniport driver must ignore this member (along with the uNumOfPhyTypeInfos member) if bRestrictedScan is set to TRUE.
uNumOfPhyTypeInfos
The number of entries in the list of PHY types.
If uNumOfPhyTypeInfos is zero, the 802.11 station performs the scan using all of its supported PHYs.
uIEsOffset
The offset in the ucBuffer array where the list of variable-length information elements (IEs) begins. The 802.11 station must append the list of IEs to the end of each Probe Request frame that it transmits during an active scan.
The miniport driver must ignore this member (along with the uIEsLength member) if dot11ScanType is set to dot11_scan_type_passive.
uIEsLength
The length, in bytes, of the list of IEs.
ucBuffer[1]
The buffer containing optional data as specified through other members of this structure.
Remarks
The 802.11 station performs explicit scan operations following the OID set request of OID_DOT11_SCAN_REQUEST. The station performs the scan operation by using the parameters defined through the DOT11_SCAN_REQUEST_V2, which accompanies the set request.
For more information about the scan operations performed by a Native 802.11 miniport driver, see Native 802.11 Scan Operations.
For more information about the ExtSTA operation mode, see Extensible Station Operation Mode.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows Vista and later versions of the Windows operating systems. |
| Header | windot11.h (include Ndis.h) |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for