Share via

DOT11_SCAN_REQUEST_V2 (Compact 2013)

  • Article

3/26/2014

This structure defines the parameters for the explicit scan operation that is performed by the 802.11 station. The station performs the explicit scan operation following a 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 when it scans on channels that are not valid in the current regulatory domain. The 802.11 station must also 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.

    Note

    The dot11_scan_type_forced bit is supported only when the miniport driver is operating in Extensible Station (ExtSTA) mode. The dot11_scan_type_forced bit must be set through a bitwise OR with a DOT11_SCAN_TYPE value.

  • 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 one of the following is 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 it scans on a channel.

  • uNumOfdot11SSIDs
    The number of entries in the SSID list.

    Note

    If uNumOfdot11SSIDs is zero, the scan request will fail with NDIS_STATUS_INVALID_DATA

  • 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 (and the uRequestIDsOffset and uNumOfRequestIDs members) if any one of the following is 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 specified PHY type from this list.

    The miniport driver must ignore this member (and 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 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 (and the uIEsLength member) if dot11ScanType is set to dot11_scan_type_passive.

  • uIEsLength
    The length, in bytes, of the list of IEs
  • ucBuffer
    The buffer that contains optional data as specified through other members of this structure

Remarks

The 802.11 station performs explicit scan operations following the set request of OID_DOT11_SCAN_REQUEST. The station performs the scan operation by using the parameters that are defined through the DOT11_SCAN_REQUEST_V2. This accompanies the set request.

Requirements

Header

windot11.h

See Also

Reference

Native 802.11 Data Types
OID_DOT11_SCAN_REQUEST
OID_DOT11_CURRENT_REG_DOMAIN
OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED
DOT11_PHY_TYPE_INFO
DOT11_SCAN_REQUEST_V2
Native 802.11 Wireless LAN Reference

Other Resources

DOT11_BSS_TYPE
DOT11_SSID