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 つの項目を追加します。 |
|
Clear コレクションからすべての項目を削除します。 |
|
Clear メソッドがコレクションからすべての項目を削除する方法について説明します。 |
|
閉じる デバイスを閉じます。 |
|
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 ターゲットの取得元のデポを識別する値を取得します。 |
|
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 メソッドは、オブジェクトのトレース レベルを設定します。 |
|
スリープ システムを目的のスリープ状態にします。 |
|
スタート メソッドがデバイスを開く方法について説明します。 |
| StartAsync を する 開始イベントの発生を非同期的に通知します。 |
|
StartTestCase テスト ケースの開始をマークします。 |
|
停止 デバイスを停止します。 |
| 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 コレクションのプロパティと操作を定義します。 |