共用方式為


DOT11_SCAN_REQUEST_V2結構(windot11.h)

重要 Windows 10 和更新版本中已淘汰 Native 802.11 無線 LAN 介面。 請改用 WLAN 裝置驅動器介面 (WDI)。 如需 WDI 的詳細資訊,請參閱 WLAN 通用 Windows 驅動程式模型。

DOT11_SCAN_REQUEST_V2 結構會定義 802.11 月臺所執行之明確掃描作業的參數。 月臺會在 OID_DOT11_SCAN_REQUEST的 OID 集合要求之後,執行明確的掃描作業。

語法

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;

成員

dot11BSSType

802.11 月台掃描的基本服務集 (BSS) 網路類型。 這個成員的數據類型是 DOT11_BSS_TYPE 列舉。

dot11BSSID

802.11 月台掃描之 BSS 網路的 BSS 識別元 (BSSID) 。 如果此成員設定為通配符 BSSID (0xFFFFFFFFFFFF),月臺會掃描所有 BSSID。

dot11ScanType

802.11 月臺執行的掃描類型。 這個成員的數據類型是DOT11_SCAN_TYPE列舉,它會宣告下列值:

dot11_scan_type_active

月臺會在掃描的每個通道上傳送 802.11 探查要求框架。 其停留在通道上足夠長,足以接收其探查要求的 802.11 探查響應畫面。 該站還接收了在頻道上傳送的802.11個信標框架。

dot11_scan_type_passive

月臺不會在掃描的每個通道上傳輸 802.11 探查要求框架。 相反地,它會接收在通道上傳送的 802.11 指標或探查要求畫面格。

dot11_scan_type_auto

月臺可以執行主動或被動掃描,也可以使用這兩種掃描類型的組合。

不論 dot11ScanType 的值為何,802.11 月臺在目前監管網域中無效的通道上掃描時,都必須執行 dot11_scan_type_passive 掃描類型。 此外,如果 802.11 月台沒有預設的法規網域,則必須執行 dot11_scan_type_passive 掃描類型。 如需法規網域的詳細資訊,請參閱 OID_DOT11_CURRENT_REG_DOMAIN

如果在 dot11ScanType 成員中設定 dot11_scan_type_forced 位,則 802.11 月台必須在每個支援的通道上執行完整掃描。 如果未設定 dot11_scan_type_forced 位,802.11 月臺可以執行完整的掃描,也可以對支援的通道子集執行部分掃描。

Note 只有在迷你埠驅動程式以 Extensible Station (ExtSTA) 模式運作時,才支援 dot11_scan_type_forced 位。 dot11_scan_type_forced 位必須透過具有DOT11_SCAN_TYPE值的位 OR 進行設定。

bRestrictedScan

如果此成員 TRUE,則 802.11 月臺會執行限制為通道和 PHY 組態的掃描,以連線到 BSS 網路。

如果下列任一項成立,迷你埠驅動程序必須忽略此成員:

  • 迷你埠驅動程式以 ExtSTA 模式運作。
  • 802.11 月臺未連線到 BSS 網路。

udot11SSIDsOffset

ucBuffer 陣列中的位移,服務集標識碼 (SSID) 清單開始的位置。 SSID 清單中的每個項目都會格式化為 DOT11_SSID 結構。

802.11 月臺會掃描清單中每個 SSID。 例如,如果 dot11ScanType 設定為 dot11_scan_type_active,則 802.11 月臺會在通道上掃描時,針對清單中的每個 SSID 傳送 802.11 探查要求。

uNumOfdot11SSIDs

SSID 清單中的項目數目。

如果 uNumOfdot11SSIDs 為零,迷你埠驅動程式必須使用包含通配符零長度 SSID 的 SSID 清單。

bUseRequestIE

如果此成員 TRUE,則 802.11 月臺必須包含要求標識符清單(透過 uRequestIDsOffset 定義,以及 uNumOfRequestIDs 成員)在 802.11d 要求資訊元素 (IE) 內,在作用中掃描期間傳輸的每個探查要求框架中。

如果下列任一項成立,迷你埠驅動程序必須忽略此成員(連同 uRequestIDsOffsetuNumOfRequestIDs 成員] :

  • 迷你埠驅動程式以 ExtSTA 模式運作。
  • 802.11 dot11MultiDomainCapabilityEnabled 管理資訊基底 (MIB) 物件 FALSE。 如需 dot11MultiDomainCapabilityEnabled MIB 對象的詳細資訊,請參閱 OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED
  • dot 11ScanType 成員會設定為 dot11_scan_type_passive

uRequestIDsOffset

ucBuffer 陣列中開始要求標識子清單的位移。 要求標識子清單中的每個項目都會格式化為UCHAR資料類型。

uNumOfRequestIDs

要求標識碼清單中的項目數目。

uPhyTypeInfosOffset

ucBuffer 陣列中開始 PHY 類型清單的位移。 PHY 類型清單中的每個項目都會格式化為 DOT11_PHY_TYPE_INFO 結構。

802.11 月台必須使用這份清單中的每個指定的 PHY 類型來執行 BSS 掃描。

如果 bRestrictedScan 設為 TRUE,迷你埠驅動程序必須忽略這個成員(以及 uNumOfPhyTypeInfos 成員)。

uNumOfPhyTypeInfos

PHY 類型清單中的項目數。

如果 uNumOfPhyTypeInfos 為零,則 802.11 月臺會使用其所有支援的 PHY 來執行掃描。

uIEsOffset

ucBuffer 中的位移 陣列,其中變數長度資訊專案 (IES) 的清單開始。 802.11 月台必須將 IE 清單附加至在主動掃描期間傳輸的每個探查要求框架結尾。

如果 dot11ScanType 設定 dot11_scan_type_passive ,則迷你埠驅動程序必須忽略此成員(連同 uIEsLength 成員)。

uIEsLength

IES 清單的長度,以位元組為單位。

ucBuffer[1]

緩衝區,包含透過這個 結構的其他成員所指定的選擇性數據。

言論

802.11 月臺會遵循 OID_DOT11_SCAN_REQUEST的 OID 集合要求,執行明確的掃描作業。 月臺會使用透過DOT11_SCAN_REQUEST_V2定義的參數來執行掃描作業,其隨附於設定要求。

如需 Native 802.11 迷你埠驅動程式所執行掃描作業的詳細資訊,請參閱 Native 802.11 Scan Operations

如需 ExtSTA 作業模式的詳細資訊,請參閱 可延伸月臺作業模式

要求

要求 價值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows作系統中使用。
標頭 windot11.h (包括 Ndis.h)

另請參閱

DOT11_PHY_TYPE_INFO

OID_DOT11_SCAN_REQUEST