OID_WDI_TASK_SCAN

重要

本主題是 Windows 10 中發行的WDI 驅動程式模型一部分。 WDI 驅動程式模型處於維護模式，而且只會收到高優先順序修正。 WiFiCx是在 Windows 11 中發行的Wi-Fi驅動程式模型。 建議您使用 WiFiCx 來利用最新的功能。

OID_WDI_TASK_SCAN要求 BSS 網路的問卷。 埠會根據 IEEE 802.11 規格的需求來執行掃描。

Object	支援中止	主機驅動程式原則 (預設優先順序)	正常執行時間 (秒)
連接埠	是的。 埠必須在中止之後處於乾淨狀態。	6 (背景掃描) 5 (使用者起始掃描)	4

一旦埠啟動掃描，並準備好接收其他命令，就會指出包含 WDI_TLV_STATUS 的工作啟動訊息。

一旦 LiveUpdatesNeeded 啟用掃描後，埠就必須使用有關探索到 BSS 專案的NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST) 指示，提供累加式更新 (。 先前探索到但目前掃描中埠找不到的 BSS 專案，不應由埠報告。 基於電源和效能考慮，埠應該只會在探索到 3 或更多專案時，或探索不到 3 個專案，但未將更新報告給主機超過 500 毫秒時，才會對主機進行節流控制並傳送更新。 掃描完成之後，如果配接器未管理 BSS 專案，則不需要記住其探索到的 BSS 專案。 掃描工作完成後，埠必須將工作完成通知傳送至作業系統，並停止向主機報告 BSS 專案。 掃描命令用於尋找舊版 (非Wi-Fi Direct網路) ，且埠不應在探查要求中包含Wi-Fi Direct IE。

如果配接器未管理 BSS 專案，主機會記住埠從掃描回報的 BSS 專案有限期間。 它會逾時快取的專案，並排清它們。 如果配接器管理 BSS 專案，它會快取並逾時。主機可能會傳送 OID_WDI_SET_FLUSH_BSS_ENTRY 命令，以明確排清專案。

主機會使用 BSSID 追蹤 BSS 專案。 如果埠針對相同的 BSSID 報告兩個 BSS 專案，主機會彼此覆寫。

掃描進行時，埠必須維護現有的連線 (，例如基礎結構或Wi-Fi直接) 。 如果連線已經存在，埠應該一次掃描通道的子集，並在子集之間掃描，以提供媒體的其他連線存取權。 在掃描期間，主機可以將封包傳送要求提交至介面卡上的任何埠。

在指定的 BSS 專案中，埠可以包含裝置特定內容資訊。 如果要求埠連線到該 BSS 專案，此內容資訊會傳回裝置。 不過，如果 BSS 專案已排清，主機可能會自動清除此內容。

掃描命令可以中止。 在接收中止命令時，埠應該停止嘗試尋找新的 BSS 網路，並儘快完成掃描工作。 當工作正常完成或因為中止) 而完成 (時，埠應該處於良好狀態，讓該埠可以發出另一個掃描。

配接器在執行掃描時不得違反法規限制。

工作參數

TLV	允許多個 TLV 實例	選用	描述
WDI_TLV_BSSID			要掃描的網路 BSSID。 如果這是廣播 MAC 位址，月臺會掃描所有 BSSID。
WDI_TLV_SSID	X		埠應該掃描的 SSID 清單清單。 此清單中可以有多個 SSD，其中一個可以是萬用字元。 在通道上執行作用中掃描時，埠必須針對清單中的每個 SSID 傳送探查要求。 如果此清單是空的，埠必須掃描所有 SSD。
WDI_TLV_VENDOR_SPECIFIC_IE		X	必須包含在埠所傳送探查要求中的一或多個 IE。 這些 IDE 不會用於被動掃描。
WDI_TLV_SCAN_MODE			掃描模式參數。
WDI_TLV_SCAN_DWELL_TIME			停留時間參數。
WDI_TLV_BAND_CHANNEL	X	X	要掃描的建議通道清單。 只要配接器符合最大掃描時間需求，配接器就可以在通道清單的子集或超集合上執行掃描。 如果這份清單是空的，埠必須掃描所有支援的通道。

工作完成指示

NDIS_STATUS_WDI_INDICATION_SCAN_COMPLETE

未經請求的指示

NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST

裝置會使用此通知來告知主機 BSS 專案的更新。 您可以隨時傳送它。

規格需求

最低支援的用戶端	Windows 10
最低支援的伺服器	Windows Server 2016
標頭	Dot11wdi.h