DOT11_SCAN_REQUEST_V2 結構 (windot11.h)
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
基本服務集的類型 (BSS) 網路，802.11 月臺會掃描。 這個成員的數據類型是 DOT11_BSS_TYPE 列舉。
dot11BSSID
BSS 識別碼 (BSSID) 802.11 月台掃描的 BSS 網路。 如果此成員設定為通配符 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。
如果 dot11_scan_type_forced 位是在 dot11ScanType 成員中設定，802.11 月台必須在每個支援的通道上執行完整掃描。 如果未設定 dot11_scan_type_forced 位，802.11 月臺可以執行完整掃描，或可以在支援的通道子集上執行部分掃描。
bRestrictedScan
如果此成員為 TRUE，則 802.11 月臺會執行限制為連線至 BSS 網路的通道和 PHY 設定的掃描。
如果下列任一專案成立，迷你埠驅動程式就必須忽略此成員：
- 迷你埠驅動程式是以 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) 在作用中掃描期間傳輸的每個探查要求框架。
迷你埠驅動程序必須忽略此成員 (以及 uRequestIDsOffset 和 uNumOfRequestIDs 成員，如果下列任一項成立，) ：
- 迷你埠驅動程式是以 ExtSTA 模式運作。
- 802.11 dot11MultiDomainCapabilityEnabled 管理資訊基底 (MIB) 物件為 FALSE。 如需 dot11MultiDomainCapabilityEnabled MIB 對象的詳細資訊，請參閱 OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED。
- dot11ScanType 成員會設定為 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 陣列中的位移，其中可變長度資訊元素的清單 (I) 開始。 802.11 月台必須將 I 清單附加至作用中掃描期間所傳輸的每個探查要求框架結尾。
如果 dot11ScanType 設定為 dot11_scan_type_passive，迷你埠驅動程式必須忽略此成員 (以及 uIEsLength 成員 ) 。
uIEsLength
IE 清單的長度，以位元組為單位。
ucBuffer[1]
緩衝區，包含透過這個 結構其他成員所指定的選擇性數據。
備註
802.11 月臺會遵循 OID_DOT11_SCAN_REQUEST的 OID 集合要求來執行明確的掃描作業。 月臺會使用透過DOT11_SCAN_REQUEST_V2定義的參數來執行掃描作業，其隨附於設定要求。
如需 Native 802.11 迷你埠驅動程式所執行掃描作業的詳細資訊，請參閱 Native 802.11 掃描作業。
如需 ExtSTA 作業模式的詳細資訊，請參閱 可延伸月臺作業模式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
| 標頭 | windot11.h (include Ndis.h) |