Windows Device Testing Framework (WDTF)

Windows 裝置測試架構概觀 (WDTF) 技術。

若要開發 Windows Device Testing Framework (WDTF) ，您需要下列標頭：

• comtracing.h
• interruption.h
• itestresource.h
• logcoNtext.h
• logcontroller.h
• logtestresults.h
• preservelasterror.h
• resourcelist.h
• runtimeparameters.h
• screencapture.h
• te.common.h
• testdata.h
• testnotification.h
• throw.h
• tracing.h
• verify.h
• wdtf.h
• wdtfedtaction.h
• wdtfinterfaces.h
• wdtfinterfacessup.h
• wdtflogging.h
• wdtfpnpaction.h
• wdtfsimulatedbatterysystemaction.h
• wdtfsystemaction.h
• wex.common.h
• wex.logger.h
• wexassert.h
• wexdebug.h
• wexexception.h
• wexlogtrace.h
• wexstring.h
• wextestclass.h
• wextypes.h
• wppdefs.h

如需程式設計指南，請參閱 Windows 裝置測試架構 (WDTF) 。

列舉

TTraceLevel TTraceLevel 列舉會定義一組層級，以在 WDTF 中追蹤。 每個層級的意義取決於 ITracer 介面的登錄設定。

函式

加入 將單一動作新增至集合。
加入 將單一長數加入至集合。
加入 將單一數位加入集合中。
加入 將單一字串加入至集合。
加入 將單一專案新增至集合。
清除 移除集合的所有項目。
清除 瞭解 方法如何從集合中移除所有專案。
關閉 關閉裝置。
ConnectedStandby 讓系統進入連線待命狀態，並在所需的時間通過之後結束連線待命狀態。 這個方法僅適用于支援 Always On Always Connected (AOAC) 的電腦上。
繼續 繼續 I/O。
ContinueAsync 以非同步方式發出 I/O 的訊號以繼續。
停用 停用目標裝置上的增強型裝置測試 (EDT) 篩選驅動程式。
停用 瞭解方法如何停用目標裝置上的增強型裝置測試 (EDT) 篩選驅動程式。
DisableDevice 停用目標裝置。
DisableDevice 瞭解 方法如何停用目標裝置。
DisableObjectErrorLogging 停用動作的物件錯誤記錄。
DisableObjectErrorLogging 停用集合中所有動作的物件錯誤記錄。
DisableObjectErrorLogging 停用所有物件的物件錯誤記錄。
DisableObjectLogging 停用動作的物件記錄。
DisableObjectLogging 停用集合中所有動作的物件記錄。
DisableObjectLogging 停用所有物件的物件記錄。
DisableRealBatteries 如果電池存在於系統中，則會停用實際電池。
DisableSimulatedBattery 停用模擬電池。
EDTCancelRemoveDevice 將IRP_MN_CANCEL_REMOVE_DEVICE事件傳送至目標裝置。
EDTCancelRemoveDevice 瞭解 方法如何將IRP_MN_CANCEL_REMOVE_DEVICE事件傳送至目標裝置。
EDTCancelStopDevice 將IRP_MN_CANCEL_STOP_DEVICE事件傳送至目標裝置。
EDTCancelStopDevice 瞭解 方法如何將IRP_MN_CANCEL_STOP_DEVICE事件傳送至目標裝置。
EDTSurpriseRemoveDevice 將IRP_MN_SURPRISE_REMOVAL事件傳送至目標裝置。
EDTSurpriseRemoveDevice 瞭解 方法如何將IRP_MN_SURPRISE_REMOVAL事件傳送至目標裝置。
EDTTryStopDevice 嘗試將IRP_MN_STOP_DEVICE事件傳送至目標裝置。
EDTTryStopDevice 瞭解方法如何嘗試將IRP_MN_STOP_DEVICE事件傳送至目標裝置。
EDTTryStopDeviceFailRestart 此方法會嘗試將IRP_MN_STOP_DEVICE事件傳送至目標裝置，然後讓後續的裝置重新開機失敗。
EDTTryStopDeviceFailRestart 瞭解 EDTTryStopDeviceFailRestart 方法如何嘗試將IRP_MN_STOP_DEVICE事件傳送至目標裝置，然後讓後續的裝置重新開機失敗。
EDTTryStopDeviceRequestNewResources 嘗試將IRP_MN_STOP_DEVICE事件傳送至目標裝置，並將新資源指派給目標裝置。
EDTTryStopDeviceRequestNewResources 瞭解方法如何嘗試將IRP_MN_STOP_DEVICE事件傳送至目標裝置，並將新資源指派給目標裝置。
啟用 啟用目標裝置上的增強型裝置測試 (EDT) 篩選驅動程式。
啟用 瞭解如何在目標裝置上啟用增強型裝置測試 (EDT) 篩選驅動程式。
EnableDevice 啟用目標裝置。
EnableDevice 瞭解 方法如何啟用目標裝置。
EnableObjectErrorLogging 啟用動作的物件錯誤記錄。
EnableObjectErrorLogging 啟用集合中所有動作的物件錯誤記錄。
EnableObjectErrorLogging 啟用所有物件的物件錯誤記錄。
EnableObjectLogging 啟用動作的物件記錄。
EnableObjectLogging 啟用集合中所有動作的物件記錄。
EnableObjectLogging 啟用所有物件的物件記錄。
EnableRealBatteries 如果實際電池存在於系統中，則啟用實際電池。
EnableSimulatedBattery 啟用模擬電池。
EndTestCase 標記測試案例的結尾。
Eval 評估此目標是否符合 SDEL 語句。
Eval 評估集合中的所有專案是否符合 SDEL 語句。
get__NewEnum 取得 For Each 迴圈結構隱含使用的新反復專案變數。
get__NewEnum 瞭解這個 IWDTFDeviceDepot2 介面方法如何取得 For Each 迴圈結構隱含使用的新反復專案變數。
get__NewEnum 瞭解 IWDTFLongNumbers2 介面的 get__NewEnum 方法如何取得 For Each 迴圈結構隱含使用的新反復專案變數。
get__NewEnum get__NewEnum方法會取得 For Each 迴圈結構隱含使用的新反復專案變數。
get__NewEnum 瞭解 IWDTFStrings2 介面的 get__NewEnum 方法如何取得 For Each 迴圈結構隱含使用的新反復專案變數。
get__NewEnum 瞭解這個 IWDTFTargets2 介面方法如何取得 For Each 迴圈結構隱含使用的新反復專案變數。
get_Config 取得 WDTF 組態物件。
get_CoNtext 取得並設定名稱/值組，表示目標的使用者資料。
get_Count 取得這個集合中的動作數目。
get_Count 取得 DeviceDepot 目前提供的裝置數目。
get_Count 取得集合中的長數位數。
get_Count 取得集合中的數位數目。
get_Count 取得集合中的字串數目。
get_Count 取得此集合中的項目數。
get_Critical 取得或設定值，這個值表示系統電源狀態是否重要。
get_DeviceDepot 取得 DeviceDepot 物件。
get_IsRestarted 取得值，指出測試腳本是否因為呼叫 RebootRestart 或 RebootRestartWithCoNtext 而重新開機。
get_Item 取得集合中的個別動作。
get_Item 取得 DeviceDepot 中的個別裝置。
get_Item 取得集合中的個別長數位。
get_Item 取得集合中的個別數位。
get_Item 取得集合中的個別字串。
get_Item 取得集合中的個別專案。
get_Log 取得 WDTF 記錄物件。
get_RootDevice 取得根裝置。
get_SleepWakeTimeInSeconds 取得或設定系統從睡眠狀態喚醒的時間，以秒為單位。
get_SystemDepot 取得 SystemDepot 物件。
get_Target 取得這個動作所參考的目標。
get_ThisSystem 取得代表本機電腦的 IWDTFTarget2 值。
get_Type 取得值，這個值會識別目標所來自的 Depot。
get_WDTF 瞭解此屬性如何取得主要 WDTF 匯總物件。
get_WDTF 這個屬性會取得主要的 WDTF 匯總物件。
get_WDTF 這個方法會取得主要的 WDTF 匯總物件。
get_WDTF 瞭解此方法如何取得主要 WDTF 匯總物件。
GetBits GetBits 方法會根據指定的 TTraceLevel 值和 coclass 的 CLSID，傳回 coclass 的一組追蹤旗標作為位元遮罩。
GetFirstSleepState 傳回第一個支援的睡眠狀態。
GetInterface 傳回目標的動作。
GetInterfaces 傳回支援 介面的動作集合 - 每個專案都有一個 IWDTFAction2。
GetInterfacesIfExist 瞭解方法如何傳回支援 介面的動作集合 -每個專案都有一個 IWDTFAction2。
GetNextSleepState 傳回下一個支援的睡眠狀態。
GetRelations 傳回相關目標的集合。
GetStatus 傳回最後一個作業的狀態碼。
GetStatusString 傳回最後一個作業的狀態做為字串。
GetValue 從與指定屬性相關聯的目標傳回值。
GetValueBool 從與指定屬性相關聯的目標傳回布林值。
GetValueLongNumber 從與指定屬性相關聯的目標傳回長數位值。
GetValueLongNumbers 從與指定屬性相關聯的目標傳回長數位值的集合。
GetValueNumber 從與指定屬性相關聯的目標傳回數位值。
GetValueNumbers 從與指定屬性相關聯的目標傳回數位值的集合。
GetValueString 從與指定屬性相關聯的目標傳回字串值。
GetValueStrings 從與指定屬性相關聯的目標傳回字串值的集合。
HasCoNtext 判斷目標是否有指定的內容存在。
HasInterface 判斷目標是否支援指定的介面。
IsEnabled 取得值，指出目標裝置上是否啟用增強型裝置測試 (EDT) 篩選驅動程式。
IsEnabled 瞭解 方法如何取得值，指出目標裝置上是否啟用增強型裝置測試 (EDT) 篩選驅動程式。
IsRebootRequired 取得值，指出增強型裝置測試 (EDT) 篩選驅動程式是否需要重新開機。
IsRebootRequired 瞭解方法如何取得值，指出增強型裝置測試 (EDT) 篩選器驅動程式是否需要重新開機。
IsRestartedWithCoNtext 取得值，這個值表示是否針對特定內容重新開機測試腳本。
IsStatusSuccess 取得值，這個值表示最後一個作業是否成功。
開啟 開啟裝置。
OutputError 將錯誤專案寫入測試案例記錄。
OutputInfo 將參考專案寫入測試案例記錄。
暫停 暫停 I/O。
PerformIO 對裝置執行少量的簡單 I/O。
PowerAnalyzeTraceByFile 分析已收集並儲存在相關聯追蹤訊息 (.etl) 記錄檔中的電源追蹤會話。 此方法僅適用于 Windows 8 和更新版本。
PowerTracingEnd 這個方法會結束電源追蹤會話。
PowerTracingStart 啟動電源狀態轉換的追蹤會話，並將追蹤訊息檔案儲存在目前工作目錄中 (Wdtfpwr.etl) 。 此方法可從 Windows 8 開始使用。
PowerTracingStartByFile 啟動電源狀態轉換的追蹤會話，並使用指定的路徑將追蹤訊息檔案儲存 (.etl) 。 此方法可從 Windows 8 開始使用。
put_CoNtext 瞭解 方法如何取得及設定代表目標使用者資料的名稱/值組。
put_Critical 設定或取得值，指出系統電源狀態是否重要。
put_SkipRestart 設定值，指出目標裝置是否應該預設重新開機。
put_SkipRestart 瞭解 方法如何設定值，指出目標裝置是否應該預設重新開機。
put_SleepWakeTimeInSeconds 設定或取得系統從睡眠狀態喚醒的時間，以秒為單位。
查詢 傳回 DeviceDepot 中裝置的子集。
查詢 傳回集合中專案的子集。
QuerySingle 從 DeviceDepot 傳回單一目標裝置。
QuerySingle 從集合傳回單一專案。
RebootRestart 重新開機系統和目前的測試。
RebootRestartWithCoNtext 重新開機系統，並使用內容資料重新開機測試腳本。
移除 從集合中移除動作。
移除 從集合中移除長數位。
移除 從集合中移除數位。
移除 從集合移除字串。
移除 從集合中移除項目。
RemoveDevice 移除裝置。
RemoveDevice 瞭解方法如何移除裝置。
RequestEjectDevice 起始裝置退出。
RequestEjectDevice 瞭解方法如何起始裝置退出。
RescanDevice 重新掃描目標裝置。
RescanDevice 瞭解方法如何重新掃描目標裝置。
RescanParentDevice 重新掃描並重新列舉目標裝置的父裝置。
RescanParentDevice 瞭解方法如何重新掃描並重新列舉目標裝置的父裝置。
RestartDevice 起始裝置重新開機。
RestartDevice 瞭解 方法如何起始裝置重新開機。
SetSimulatedBatteryChargePercentage 設定模擬電池回報給 OS 的收費百分比。
SetSimulatedBatteryToAC 將模擬電池狀態設定為 AC 電源。
SetSimulatedBatteryToDC 將模擬電池狀態設定為 DC 電源。
SetTarget WDTF 會在內部使用 SetTarget 方法。 請勿直接呼叫這個方法。
SetTraceLevel SetTraceLevel 方法會設定物件的追蹤層級。
Sleep 讓系統進入所需的睡眠狀態。
啟動 瞭解方法如何開啟裝置。
StartAsync 以非同步方式發出開始事件的訊號。
StartTestCase 標記測試案例的開頭。
停止 停止裝置。
StopAsync 以非同步方式發出停止事件的訊號。
WaitAsyncCompletion 等候任何非同步事件完成。

介面

IAction IAction 介面是可控制 IWDTFTarget2 介面實例的外掛程式。
Itracer ITracer 介面可讓每個 WDTF 介面的個別實例判斷指定實作 coclass 的特定追蹤設定。 這些設定會記錄在登錄中。
ITracing ITracing 介面會設定物件的 TTraceLevel 值。 此介面是大部分 WDTF 介面的基底介面。
IWDTF2 定義 WDTF 集合的屬性。
IWDTFAction2 定義可控制 IWDTFTarget2 介面實例的作業和屬性。
IWDTFActions2 定義 IWDTFTargets：：GetInterfaces 方法傳回之動作集合的作業和屬性。
IWDTFCONFIG2 定義控制測試腳本內 WDTF 物件的作業。
IWDTFDeviceDepot2 定義電腦上裝置集合的屬性和作業。
IWDTFEnhancedDeviceTestSupportAction2 定義支援增強型裝置測試 (EDT) 篩選驅動程式的作業和屬性。
IWDTFEnhancedDeviceTestSupportActions2 定義支援增強型裝置測試 (EDT) 動作集合的作業和屬性。
IWDTFLOG2 定義可讓測試案例作者新增至 WDTF 測試記錄檔的作業。
IWDTFLongNumbers2 定義長數位集合的作業和屬性。
IWDTFNumbers2 定義數位集合的作業和屬性。
IWDTFPNPAction2 定義隨插即用 (PNP) 裝置相關測試介面的作業和屬性。
IWDTFPNPActions2 定義隨插即用 (PNP) 裝置相關測試介面集合的作業和屬性。
IWDTFSimpleIOEx2 定義簡單同步 I/O 功能測試的作業。
IWDTFSimpleIOStressAction2 定義簡單非同步 I/O 功能測試的作業。
IWDTFSimpleIOStressActions2 定義簡單非同步 I/O 功能測試集合的作業。
IWDTFSimulatedBatterySystemAction IWDTFSimulatedBatterySystemAction 介面
IWDTFStrings2 定義字串集合的作業和屬性。
IWDTFSystemAction2 定義支援驅動程式測試的作業和屬性。
IWDTFSystemDepot2 定義 SystemDepot 的作業和屬性 - 代表本機電腦的 物件。
IWDTFTarget2 定義可測試專案的作業和屬性。
IWDTFTargets2 定義集合的屬性和作業。