提供的 WDTF 簡單 I/O 外掛程式

發行項
02/08/2024

簡單的 I/O 外掛程式是實作一般裝置特定 I/O 功能的 Windows 驅動程式測試架構 (WDTF) 延伸模組。如果所測試裝置類型的外掛程式存在，裝置基礎測試會使用WDTF簡單 I/O 介面來測試 I/O。

本主題列出具有簡單 I/O 外掛程式的裝置類型，並指出是否有測試裝置的特定需求。當您使用 Windows 硬體實驗室套件 (Windows HLK) 時，您需要遵循這些需求。本主題也提供疑難解答和分級測試失敗的想法。

如果您的裝置類型未列出，您可以建立一個，請參閱如何使用WDTF簡單 I/O 動作外掛程式自定義裝置的 I/O

如需具有特定需求的裝置基本測試清單，請參閱具有特定裝置設定需求的裝置基本測試

音訊

規格需求

裝置必須至少有一個轉譯類型端點連線 (喇叭、耳機或這類) 。
如果目標音訊裝置具有 HDMI 視訊和音訊輸出功能，若要執行音訊測試，裝置必須連接到 HDMI 音訊可用的裝置，例如 HDMI 監視器或 A/V 接收器。

I/O 外掛程式的類型會執行 (音訊)

在轉譯類型端點上播放正弦微調。擷取類型端點上的音訊。

如何分級測試失敗

查看失敗的 HRESULT 以執行初始分級。
如果測試沒有回應，請使用目標計算機上的核心調試程式來縮小根本原因。
執行追蹤：
- 啟動核心追蹤：

xperf.exe -on LOADER+PROC_THREAD+CSWITCH+DISK_IO+HARD_FAULTS+PROFILE+INTERRUPT+NETWORKTRACE+DPC+Latency+POWER -stackwalk ProcessCreate+ProcessDelete+ImageLoad+ImageUnload+ThreadCreate+ThreadDelete+CSwitch+ReadyThread+Profile+DiskFlushInit+FileFlush+RegFlush+HardFault+VirtualAlloc+VirtualFree -BufferSize 1024 -MinBuffers 512 -MaxBuffers 1024 -f Audio_SimpleIo_Kernel.etl

啟動音訊追蹤：

xperf.exe -start AudioSimpleIo -on Microsoft-Windows-Audio+a6a00efd-21f2-4a99-807e-9b3bf1d90285:0xffff:0x3 -BufferSize 1024 -MinBuffers 512 -MaxBuffers 1024 -f Audio_SimpleIo.etl

執行測試。
停止追蹤：

xperf.exe -stop "NT Kernel Logger" Audio_SimpleIo

合併追蹤：

xperf.exe -merge Audio_SimpleIo_Kernel.etl Audio_SimpleIo.etl Audio_SimpleIo _Merged.etl

使用 Xperf (xperfview) 檢視合併的追蹤檔案。

藍牙

藍牙需求

沒有特殊需求。

I/O 外掛程式的類型會執行 (藍牙)

使用 BluetoothFindFirstDevice 函式 來尋找藍牙裝置。

CDROM

CDROM 需求

指派驅動器號。
媒體存在於裝置中。
檔案會出現在插入的媒體上。

I/O 外掛程式的類型會執行 (CDROM)

尋找 CD-ROM 上的檔案，並使用 Win32 ReadFile API 執行讀取作業。

如何將 CDROM) (測試失敗分級

在測試計算機上，流覽至有問題的CD/DVD磁碟驅動器，並確認您可以存取磁碟驅動器的內容。
CD-Rom 簡單 I/O 外掛程式會搜尋 CD/DVD 上的檔案，以用來執行讀取。確定 CD/DVD 已在磁碟上編碼檔案。
這個簡單 I/O 外掛程式使用 Win32 CreateFile、WriteFile、ReadFile 函式。傳回的錯誤很可能是來自這些 API 的 Win32 錯誤碼。

磁碟

磁碟需求

已指派至少一個相關聯的磁碟區驅動器號。

I/O 外掛程式的類型會執行 (磁碟)

使用磁碟區的簡單 I/O 外掛程式。

顯示

顯示需求

測試沒有特殊需求。

I/O 外掛程式的類型會執行 (顯示)

使用 D3DX API 來練習圖形配接器。

如何分類測試失敗 (顯示)

查看測試記錄，其中會報告來自所使用 API 的失敗。

系統中的 GPS 裝置 (和 GPS 裝置)

GPS) 需求 (

裝置必須在具有適當 GPS 訊號的位置進行測試。

I/O 外掛程式的類型會執行 (GPS)

使用感測器的 I/O 外掛程式。

LAN

LAN (需求)

裝置具有 IPv6 位址。
裝置有 IPv6 閘道位址 (否則，WDTFREMOTESYSTEM 參數應該以測試 NIC 可以偵測的 IPv6 位址傳遞給測試) 。
裝置的網路作業狀態為 IfOperStatusUp。
網路裝置不是 WWAN 或 WLAN 裝置。

I/O 外掛程式的類型會執行 (LAN)

PingS IPv6 網路閘道位址。

如何將 LAN) (測試失敗分級

確認有現有的IP位址。
確認有閘道 IPv6 IP 位址。
請手動確認IP閘道位址， (使用 ping.exe) 。

行動寬頻

行動寬頻 (需求)

測試沒有特殊需求。

I/O 外掛程式類型會執行行動寬頻 ()

使用 IMbnInterface 介面 並呼叫 GetHomeProvider、 IMbnInterface：：GetInterfaceCapability 方法和IMbnInterface：：GetReadyState 方法 API 來練習裝置。

如何將測試失敗分級 (行動寬頻)

MobileBroadbandPlugin 有有限的區域可能會失敗。
- 「MobileBroadbandPlugin：取得所有行動寬頻介面傳回失敗」。
- “MobileBroadbandPlugin：取得介面傳回失敗。”
- “MobileBroadbandPlugin：取得傳回 DeviceId。
- “MobileBroadbandPlugin：取得介面功能傳回失敗”
- “MobileBroadbandPlugin：取得 ReadyState 傳回失敗。”
調查失敗的最佳位置是從裝置開始，並判斷它是否無法指出就緒資訊或裝置功能。若要偵錯進一步的OS追蹤檔案，必須收集。
- 執行命令： netsh 追蹤啟動wwan_dbg
- 重現問題。
- 執行命令： netsh 追蹤停止

可攜式裝置

(可攜式裝置的需求)

裝置具有可建立資料夾和檔案的儲存元件。

I/O 外掛程式類型會執行 (可攜式裝置)

使用 WPD API 將檔案讀取和寫入 WPD 裝置上的記憶體元件。

智慧卡讀卡機

智慧卡閱讀機 (需求)

裝置已插入 Athena T0 測試卡片。

I/O 外掛程式類型會執行 (智慧卡閱讀機)

讀取數據並將數據寫入卡片讀取器中插入的 Athena T0 記憶卡。

感應器

感測器 (需求)

GPS 裝置必須在具有適當 GPS 訊號的位置進行測試。

磁碟區

需求 (磁碟區)

磁碟區已指派驅動器號。
磁碟區有 5 MB 的可用空間。
磁碟區不受寫入保護。
媒體存在於裝置中。

I/O 外掛程式的類型會執行磁碟區 ()

建立名為 WDTF_Volume_IO 的目錄，並建立名為 SimpleIO.tmp 的檔案。 I/O 是藉由呼叫 ReadFile 和 WriteFile API 來執行此檔案。

如何分類 (磁碟區) 的測試失敗

在測試計算機上，流覽至有問題的磁碟驅動器，並確認您可以存取磁碟驅動器的內容。
嘗試將檔案儲存到磁碟驅動器。請確定您可以立即儲存並存取它。
這個簡單的 I/O 外掛程式會使用 Win32 CreateFile、 WriteFile、 ReadFile 函式。傳回的錯誤很可能是來自這些 API 的 Win32 錯誤碼。

網路攝影機

網路攝影機 (需求)

沒有測試的特殊需求。

注意

網路攝影機裝置的簡單 I/O 外掛程式相依於 MFPlat.dll 檔案，不適用於不包含媒體播放機和相關技術的 Windows 版本，例如 Windows 7 N 或 Windows 7 KN。在這些版本的 Windows 上，必須安裝媒體功能套件。媒體功能套件可供下載。如需詳細資訊，請參閱知識庫文章968211。

I/O 外掛程式的類型會執行網路攝影機 (網路攝影機)

使用媒體基礎介面來擷取視訊。

WLAN

具有 Mutt 的 USB 控制器和中樞

USB) 需求 (

沒有測試的特殊需求。

裝置有符號連結。

I/O 外掛程式的類型會執行 (USB)

使用 Microsoft USB 測試工具的 USB 傳輸測試 (MUTT) 裝置。涵蓋的傳輸類型為控制、大量、連續、中斷和串 (流，只有在 SuperMUTT 插入 USB 3.0 控制器)

如何分類 USB) (測試失敗

首先，檢查測試記錄檔中的訊息。
在USB 2.0和USB 3.0堆疊上啟用Windows (ETW 的事件追蹤) ，以進一步調查。
- 如需USB 2.0，請參閱 Windows 7 USB 核心堆疊中的 Microsoft Windows USB 核心小組部落格 - ETW
- 如需 USB 3.0，請參閱 Microsoft Windows USB Core 小組部落格 - 如何在 Windows 8 中擷取及讀取 USB ETW 追蹤

具有特定裝置設定需求的裝置基本測試

執行下列裝置基本測試之前，測試計算機上的裝置必須根據本主題針對特定裝置類型中所述的需求進行設定。

僅) PCI 根埠意外移除測試 (PCI 裝置
裝置路徑練習 (認證)
睡眠和 PNP (停用並啟用 IO (認證之前和之後) )
隨插即用驅動程式測試 (認證)
並行硬體和作業系統 (CHAOS) 測試 (認證)
在 (認證之前和之後重新安裝 IO)
裝置安裝檢查文件系統一致性 (認證)
裝置安裝檢查是否有其他裝置穩定性 (認證)

裝置基本概念測試

如何使用 Visual Studio 在運行時間測試驅動程式

如何從命令提示字元在運行時間測試驅動程式

如何選取及設定裝置基本概念測試

針對裝置基本概念測試進行疑難解答

共用方式為