Windows Device Testing Framework (WDTF)
Windows Device Testing Framework (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 Device Testing Framework (WDTF)」を参照してください。
列挙
TTraceLevel TTraceLevel 列挙は、WDTF でトレースするためのレベルのセットを定義します。 各レベルの意味は、ITracer インターフェイスのレジストリ設定によって異なります。 |
関数
[追加] コレクションに 1 つのアクションを追加します。 |
[追加] 1 つの長い数値をコレクションに追加します。 |
[追加] コレクションに 1 つの数値を追加します。 |
[追加] コレクションに 1 つの文字列を追加します。 |
[追加] コレクションに 1 つの項目を追加します。 |
[クリア] コレクションからすべての項目を削除します。 |
[クリア] メソッドがコレクションからすべての項目を削除する方法について説明します。 |
閉じる デバイスを閉じます。 |
ConnectedStandby システムをコネクト スタンバイ状態にし、目的の時間が経過した後にコネクト スタンバイ状態を終了します。 このメソッドは、Always Connected (AOAC) Always Onサポートしているコンピューターでのみ機能します。 |
続行 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 ターゲットの取得元のデポを識別する値を取得します。 |
get_WDTF このプロパティが WDTF 集計オブジェクトメイン取得する方法について説明します。 |
get_WDTF このプロパティは、WDTF 集計オブジェクトメインを取得します。 |
get_WDTF このメソッドは、WDTF 集計オブジェクトメイン取得します。 |
get_WDTF このメソッドが WDTF 集計オブジェクトメイン取得する方法について説明します。 |
GetBits GetBits メソッドは、指定された TTraceLevel 値とコクラスの CLSID を指定して、コクラスのトレース フラグのセットをビット マスクとして返します。 |
GetFirstSleepState サポートされている最初のスリープ状態を返します。 |
GetInterface ターゲットのアクションを返します。 |
GetInterfaces インターフェイスをサポートするアクションのコレクション (1 つの IWDTFAction2 を持つ項目ごとに 1 つ) を返します。 |
GetInterfacesIfExist メソッドがインターフェイスをサポートするアクションのコレクション (1 つの IWDTFAction2 を持つ項目ごとに 1 つ) を返す方法について説明します。 |
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 から 1 つのターゲット デバイスを返します。 |
QuerySingle コレクションから 1 つの項目を返します。 |
RebootRestart システムと現在のテストを再起動します。 |
RebootRestartWithContext システムを再起動し、コンテキスト データを使用してテスト スクリプトを再起動します。 |
削除 コレクションからアクションを削除します。 |
削除 コレクションから長い数値を削除します。 |
削除 コレクションから数値を削除します。 |
削除 文字列をコレクションから削除します。 |
削除 コレクションからアイテムを削除します。 |
RemoveDevice デバイスを削除します。 |
RemoveDevice メソッドがデバイスを削除する方法について説明します。 |
RequestEjectDevice デバイスの取り出しを開始します。 |
RequestEjectDevice メソッドがデバイスの取り出しを開始する方法について説明します。 |
RescanDevice ターゲット デバイスを再スキャンします。 |
RescanDevice メソッドがターゲット デバイスを再スキャンする方法について説明します。 |
RescanParentDevice ターゲット デバイスの親デバイスを再スキャンして再列挙します。 |
RescanParentDevice メソッドがターゲット デバイスの親デバイスを再スキャンして再列挙する方法について説明します。 |
RestartDevice デバイスの再起動を開始します。 |
RestartDevice メソッドがデバイスの再起動を開始する方法について説明します。 |
SetSimulatedBatteryChargePercentage シミュレートされたバッテリーによって OS に報告される充電率を設定します。 |
SetSimulatedBatteryToAC シミュレートされたバッテリの状態を AC 電源に設定します。 |
SetSimulatedBatteryToDC シミュレートされたバッテリの状態を DC 電源に設定します。 |
SetTarget SetTarget メソッドは、WDTF によって内部的に使用されます。 このメソッドを直接呼び出さないでください。 |
SetTraceLevel SetTraceLevel メソッドは、オブジェクトのトレース レベルを設定します。 |
Sleep システムを目的のスリープ状態にします。 |
Start メソッドがデバイスを開く方法について説明します。 |
StartAsync 開始イベントの発生を非同期的に通知します。 |
StartTestCase テスト ケースの開始をマークします。 |
Stop デバイスを停止します。 |
StopAsync 停止イベントが発生することを非同期的に通知します。 |
WaitAsyncCompletion 非同期イベントのいずれかが完了するまで待機します。 |
インターフェイス
IAction IAction インターフェイスは、IWDTFTarget2 インターフェイスのインスタンスを制御できるプラグインです。 |
ITracer ITracer インターフェイスを使用すると、すべての WDTF インターフェイスの個々のインスタンスで、特定の実装コクラスの特定のトレース設定を決定できます。 これらの設定はレジストリに記録されます。 |
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 コレクションのプロパティと操作を定義します。 |