Winsock 核心功能測試

發行項
06/20/2023

此自動化測試會針對回送介面逐一查看一些核心 Winsock 功能，並驗證 Winsock API 介面是否已正確維護。

所有測試都涵蓋 IPv4 和 IPv6 通訊端，這些通訊端全都系結至回送介面。變化如下所示：

通訊端目錄。 列舉 Winsock 目錄、為每個傳回的 通訊協定info 結構建立通訊端， (每個通訊協定 Tuple) ，並將其系結至回送介面。
重迭的 IO。 建立 IPv4 和 IPv6 TCP 資料流程通訊端、透過回送建立連線，以及透過封鎖傳送和重迭的接收呼叫在通訊端之間傳送資料。所有資料都會驗證為已接收。
TransmitFile 變化。 確認 TransmitFile 已正確傳送資料，並實作 IPv4 和 IPv6 通訊端的 通訊端重複使用TF_DISCONNECT 旗標。建立 260 位元組的暫存檔案，並透過 TransmitFile透過 TCP 連線傳輸。接聽通訊端會使用 AcceptEx 來驗證連線和通訊端重複使用。
ConditionalAccept。 驗證透過 IPv4 和 IPv6 TCP 資料流程通訊端的條件式接受語意。測試五個連線：沒有接聽程式、傳回 CF_REJECT、傳回 CF_ACCEPT、傳回 CF_DEFER + CF_REJECT，以及傳回 CF_DEFER + CF_ACCEPT。
流。封鎖透過 IPv4 和 IPv6 TCP 資料流程通訊端傳送/接收。延遲以零接聽待辦專案接受呼叫，直到連線完成為止。
資料包。 驗證透過 IPv4 和 IPv6 UDP 通訊端傳送和接收資料包。測試透過連線/傳送/接收和無連線傳送至/接收兩者傳送資料包。
選取確認 IPv4 和 IPv6 TCP 通訊端上的 READFDS 通知，以指出連線建立、接收資料和關閉通訊端。
繫結。 驗證 IPv4 和 IPv6 TCP 通訊端的系結語意：基本系結、 SO_REUSEADDR 系結和 SO_EXCLUSIVEADDRUSE 系結。
ReadFile/WriteFile。 驗證重迭 的 ReadFile () 和 WriteFile () 函式是否可透過 IPv4 和 IPv6 TCP 通訊端正確運作。
關機。 藉由建立連線、張貼封鎖接收，以及確認呼叫關機是否完成接收零位元組的接收，以驗證 IPv4 和 IPv6 TCP 通訊端上的 shutdown () 語意。
解決。 確認將 IPv4 和 IPv6 位址從 h、decimal 和 octal 字串轉換成對應的通訊端位址結構值， (WSAAddressToString 和 WSAStringToAddress) 。
多點傳送。 針對 IPv4 和 IPv6，透過 IP_ADD_MEMBERSHIP 和 IPV6_ADD_MEMBERSHIP、傳送和接收資料至群組，以及離開群組，驗證聯結至多播群組。
JoinLeaf。 針對 IPv4 和 IPv6，透過 WSAJoinLeaf驗證聯結至多播群組、傳送和接收資料至群組，以及離開群組。
AsyncSelect。 針對 IPv4 和 IPv6 TCP 通訊端，會透過WSAAsyncSelect驗證FD_CONNECT、FD_SEND和FD_READ Windows 訊息。同時確認多播通訊端完成WSAJoinLeaf時，是否處理FD_CONNECT。
Iocp。 針對 IPv4 和 IPv6 TCP 通訊端，會進行重迭的接收呼叫，其中通訊端與 I/O 完成埠相關聯。也會驗證是否已處理重迭完成，並接收所有資料。
RAW 通訊端。 針對 IPv4 和 IPv6，建立原始通訊端、透過 重迭 IO傳送和接收網際網路控制訊息通訊協定 (ICMP) 訊息。
Pnp。 確認當非回送 IP 位址新增至第一個非回送時，是否收到重迭位址變更通知的訊號。

如需 Winsock API 的詳細資訊，請參閱 Windows Sockets 2。

測試詳細資料


規格	Filter.Driver.FileSystem.MiniFilter Filter.Driver.Anti一.MiniFilter Filter.Driver.Anti，.Winsock
平台	Windows 10，用戶端版本 (x86) Windows 10，用戶端版本 (x64) Windows Server 2016 (x64)
支援的版本	Windows 10 Windows 10 (版本 1511) Windows 10 (版本 1607) Windows 10 (版本 1703) Windows 10 (版本 1709) Windows 10 (版本 1803) Windows 10 版本 1809 Windows 10 (版本 1903) Windows 10的下一個更新
預期的執行時間 (以分鐘為單位)	30
類別	部署
以分鐘為單位的逾時 ()	1800
需要重新開機	false
需要特殊設定	false
類型	automatic

其他檔

此功能區域中的測試可能會有其他檔，包括必要條件、設定和疑難排解資訊，可在下列主題中找到 () ：

Filter.Driver 其他文件

執行測試

如需需求的詳細資訊，請參閱檔案系統測試必要條件。

此外，此測試需要下列軟體：

要與任何支援的應用程式套件一起測試的篩選驅動程式
至少有一個連線的網路介面具有有效的 IPv4 和 IPv6 位址

疑難排解

如需 HLK 測試失敗的一般疑難排解，請參閱針對 Windows HLK 測試失敗進行疑難排解。

如需疑難排解資訊，請參閱針對檔案系統測試進行疑難排解。

所有測試案例都會傳回 Pass 或 Fail。若要檢閱測試詳細資料，請檢閱 Windows HLK Studio 中的測試記錄。

注意

Windows 防火牆可能會開啟一則訊息，指出防火牆可能會封鎖測試的某些功能。不過，防火牆不會影響測試。您可以放心地忽略此訊息。

如果此程式未提供成功的測試結果，請將具有裝置特定或系統特定詳細資料的測試記錄提交至 Windows Hardware Lab Kit (HLK) 支援別名。

詳細資訊

命令語法

命令選項	描述
Winsockfunctional -protocol ip -t 「Winsock API\Current Protocols (IPv4/IPv6) \BVT」 -wtt -r -dontdisable -ipsec -notrace	您必須提供這個核心引數。
-lsponly	安裝 LSP 時，您必須附加此引數。

注意

如需此測試二進位檔的命令列說明，請輸入 /h。

檔案清單

檔案	位置
WinsockFunctional.exe	< [testbinroot] >\NTTest\NetTest\Winsock\common\
WinsockFunctional.wtl	包含測試結果的詳細輸出記錄
Wsbvt.log	測試結果的摘要輸出記錄
Bvterr.log	測試結果的摘要輸出記錄
Fnshell.ini	測試產生的暫存.ini檔案

參數

參數名稱	參數描述
LLU_LocalAdmin	LLU 執行
LLU_NetAccessOnly	LLU for Copy

共用方式為