Windows Device Testing Framework (WDTF)

Übersicht über die WdTF-Technologie (Windows Device Testing Framework).

Zum Entwickeln von Windows Device Testing Framework (WDTF) benötigen Sie die folgenden Header:

• 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

Das Programmierhandbuch finden Sie unter Windows Device Testing Framework (WDTF).

Enumerationen

TTraceLevel Die TTraceLevel-Enumeration definiert eine Reihe von Ebenen für die Ablaufverfolgung in WDTF. Die Bedeutung für jede Ebene hängt von den Registrierungseinstellungen für die ITracer-Schnittstelle ab.

Functions

Add Fügen Sie der Auflistung eine einzelne Aktion hinzu.
Add Fügt der Auflistung eine einzelne lange Zahl hinzu.
Add Fügt der Auflistung eine einzelne Zahl hinzu.
Add Fügt der Auflistung eine einzelne Zeichenfolge hinzu.
Add Fügen Sie der Auflistung ein einzelnes Element hinzu.
Clear Entfernt alle Elemente aus der Auflistung.
Clear Erfahren Sie, wie die Methode alle Elemente aus der Auflistung entfernt.
Schließen Schließt das Gerät.
ConnectedStandby Versetzt das System in den Zustand verbundener Standbymodus und beendet den Zustand Verbundener Standbymodus, nachdem die gewünschte Zeit verstrichen ist. Diese Methode funktioniert nur auf einem Computer, der Always On Always Connected (AOAC) unterstützt.
Fortsetzen Setzt die E/A-Vorgänge fort.
ContinueAsync Signalisiert die E/A asynchron, dass die E/A fortgesetzt wird.
Deaktivieren Deaktiviert den EDT-Filtertreiber (Enhanced Device Test) auf dem Zielgerät.
Deaktivieren Erfahren Sie, wie die Methode den EDT-Filtertreiber (Enhanced Device Test) auf dem Zielgerät deaktiviert.
DisableDevice Deaktiviert das Zielgerät.
DisableDevice Erfahren Sie, wie die Methode das Zielgerät deaktiviert.
DisableObjectErrorLogging Deaktiviert die Objektfehlerprotokollierung für die Aktion.
DisableObjectErrorLogging Deaktivieren Sie die Objektfehlerprotokollierung für alle Aktionen in der Auflistung.
DisableObjectErrorLogging Deaktiviert die Objektfehlerprotokollierung für alle Objekte.
DisableObjectLogging Deaktiviert die Objektprotokollierung für die Aktion.
DisableObjectLogging Deaktivieren Sie die Objektprotokollierung für alle Aktionen in der Auflistung.
DisableObjectLogging Deaktiviert die Objektprotokollierung für alle Objekte.
DisableRealBatteries Deaktiviert echte Batterien, wenn sie im System vorhanden sind.
DisableSimulatedBattery Deaktiviert den simulierten Akku.
EDTCancelRemoveDevice Sendet ein IRP_MN_CANCEL_REMOVE_DEVICE-Ereignis an das Zielgerät.
EDTCancelRemoveDevice Erfahren Sie, wie die -Methode ein IRP_MN_CANCEL_REMOVE_DEVICE-Ereignis an das Zielgerät sendet.
EDTCancelStopGeräte Sendet ein IRP_MN_CANCEL_STOP_DEVICE-Ereignis an das Zielgerät.
EDTCancelStopDevice Erfahren Sie, wie die -Methode ein IRP_MN_CANCEL_STOP_DEVICE-Ereignis an das Zielgerät sendet.
EDTSurpriseRemoveDevice Sendet ein IRP_MN_SURPRISE_REMOVAL-Ereignis an das Zielgerät.
EDTSurpriseRemoveDevice Erfahren Sie, wie die -Methode ein IRP_MN_SURPRISE_REMOVAL-Ereignis an das Zielgerät sendet.
EDTTryStopDevice Versucht, ein IRP_MN_STOP_DEVICE-Ereignis an das Zielgerät zu senden.
EDTTryStopDevice Erfahren Sie, wie die -Methode versucht, ein IRP_MN_STOP_DEVICE-Ereignis an das Zielgerät zu senden.
EDTTryStopDeviceFailRestart Diese Methode versucht, ein IRP_MN_STOP_DEVICE-Ereignis an das Zielgerät zu senden, und schlägt dann den nachfolgenden Geräteneustart fehl.
EDTTryStopDeviceFailRestart Erfahren Sie, wie die EDTTryStopDeviceFailRestart-Methode versucht, ein IRP_MN_STOP_DEVICE-Ereignis an das Zielgerät zu senden und dann den nachfolgenden Geräteneustart fehlschlägt.
EDTTryStopDeviceRequestNewResources Versucht, ein IRP_MN_STOP_DEVICE-Ereignis an das Zielgerät zu senden und dem Zielgerät neue Ressourcen zuzuweisen.
EDTTryStopDeviceRequestNewResources Erfahren Sie, wie die -Methode versucht, ein IRP_MN_STOP_DEVICE-Ereignis an das Zielgerät zu senden und dem Zielgerät neue Ressourcen zuzuweisen.
Aktivieren Aktiviert den EDT-Filtertreiber (Enhanced Device Test) auf dem Zielgerät.
Aktivieren Erfahren Sie, wie die -Methode den EDT-Filtertreiber (Enhanced Device Test) auf dem Zielgerät aktiviert.
EnableDevice Aktiviert das Zielgerät.
EnableDevice Erfahren Sie, wie die -Methode das Zielgerät aktiviert.
EnableObjectErrorLogging Aktiviert die Objektfehlerprotokollierung für die Aktion.
EnableObjectErrorLogging Aktivieren Sie die Objektfehlerprotokollierung für alle Aktionen in der Auflistung.
EnableObjectErrorLogging Aktiviert die Objektfehlerprotokollierung für alle Objekte.
EnableObjectLogging Aktiviert die Objektprotokollierung für die Aktion.
EnableObjectLogging Aktivieren Sie die Objektprotokollierung für alle Aktionen in der Auflistung.
EnableObjectLogging Aktiviert die Objektprotokollierung für alle Objekte.
EnableRealBatteries Aktiviert echte Batterien, wenn sie im System vorhanden sind.
EnableSimulatedBattery Aktiviert den simulierten Akku.
EndTestCase Markiert das Ende eines Testfalls.
Eval Bewerten Sie, ob dieses Ziel mit einer SDEL-Anweisung übereinstimmt.
Eval Wertet aus, ob alle Elemente in der Auflistung mit einer SDEL-Anweisung übereinstimmen.
get__NewEnum Ruft eine neue Iterationsvariable ab, die von der For Each-Schleifenstruktur implizit verwendet wird.
get__NewEnum Erfahren Sie, wie diese IWDTFDeviceDepot2-Schnittstellenmethode eine neue Iterationsvariable erhält, die von der For Each-Schleifenstruktur implizit verwendet wird.
get__NewEnum Erfahren Sie, wie die get__NewEnum-Methode der IWDTFLongNumbers2-Schnittstelle eine neue Iterationsvariable abruft, die von der For Each-Schleifenstruktur implizit verwendet wird.
get__NewEnum Die get__NewEnum-Methode ruft eine neue Iterationsvariable ab, die von der For Each-Schleifenstruktur implizit verwendet wird.
get__NewEnum Erfahren Sie, wie die get__NewEnum-Methode der IWDTFStrings2-Schnittstelle eine neue Iterationsvariable abruft, die von der For Each-Schleifenstruktur implizit verwendet wird.
get__NewEnum Erfahren Sie, wie diese IWDTFTargets2-Schnittstellenmethode eine neue Iterationsvariable abruft, die von der For Each-Schleifenstruktur implizit verwendet wird.
get_Config Ruft das WDTF-Konfigurationsobjekt ab.
get_Context Ruft ein Name-Wert-Paar ab, das Benutzerdaten für das Ziel darstellt, und legt es fest.
get_Count Ruft die Anzahl der Aktionen in dieser Auflistung ab.
get_Count Ruft die Anzahl der Geräte ab, die derzeit vom DeviceDepot bereitgestellt werden.
get_Count Ruft die Anzahl der langen Zahlen in der Auflistung ab.
get_Count Ruft die Anzahl der Zahlen in der Auflistung ab.
get_Count Ruft die Anzahl der Zeichenfolgen in der Auflistung ab.
get_Count Ruft die Anzahl der Elemente in dieser Auflistung ab.
get_Critical Ruft einen Wert ab, der angibt, ob der Systemleistungszustand kritisch ist, oder legt diesen fest.
get_DeviceDepot Ruft das DeviceDepot-Objekt ab.
get_IsRestarted Ruft einen Wert ab, der angibt, ob das Testskript als Ergebnis eines Aufrufs von RebootRestart oder RebootRestartWithContext neu gestartet wurde.
Get_item Ruft eine einzelne Aktion in der Auflistung ab.
Get_item Ruft ein einzelnes Gerät im DeviceDepot ab.
Get_item Ruft eine einzelne lange Zahl in der Auflistung ab.
Get_item Ruft eine einzelne Zahl in der Auflistung ab.
Get_item Ruft eine einzelne Zeichenfolge in der Auflistung ab.
Get_item Ruft ein einzelnes Element in der Auflistung ab.
get_Log Ruft das WDTF-Protokollobjekt ab.
get_RootDevice Ruft das Stammgerät ab.
get_SleepWakeTimeInSeconds Ruft die Zeit in Sekunden ab, zu der das System aus dem Ruhezustand reaktiviert wird, oder legt diese fest.
get_SystemDepot Ruft das SystemDepot-Objekt ab.
get_Target Ruft das Ziel ab, auf das sich diese Aktion bezieht.
get_ThisSystem Ruft einen IWDTFTarget2-Wert ab, der den lokalen Computer darstellt.
get_Type Ruft einen Wert ab, der das Depot identifiziert, aus dem das Ziel stammt.
get_WDTF Erfahren Sie, wie diese Eigenschaft das Standard WDTF-Aggregationsobjekt abruft.
get_WDTF Diese Eigenschaft ruft das Standard WDTF-Aggregationsobjekt ab.
get_WDTF Diese Methode ruft das Standard WDTF-Aggregationsobjekt ab.
get_WDTF Erfahren Sie, wie diese Methode das Standard WDTF-Aggregationsobjekt erhält.
GetBits Die GetBits-Methode gibt den Satz von Ablaufverfolgungsflags für eine Co-Klasse als Bitmaske zurück, wenn ein angegebener TTraceLevel-Wert und die CLSID der Co-Klasse angegeben sind.
GetFirstSleepState Gibt den ersten unterstützten Ruhezustand zurück.
Getinterface Gibt eine Aktion für das Ziel zurück.
Getinterfaces Gibt eine Auflistung von Aktionen zurück, die die Schnittstelle unterstützen– eine IWDTFAction2 für jedes Element, das eine hat.
GetInterfacesIfExist Erfahren Sie, wie die -Methode eine Sammlung von Aktionen zurückgibt, die die Schnittstelle unterstützen – eine IWDTFAction2 für jedes Element, das eine hat.
GetNextSleepState Gibt den nächsten unterstützten Ruhezustand zurück.
GetRelations Gibt eine Auflistung verwandter Ziele zurück.
GetStatus Gibt den status Code für den letzten Vorgang zurück.
GetStatusString Gibt den status für den letzten Vorgang als Zeichenfolge zurück.
Getvalue Gibt einen Wert aus dem Ziel zurück, der einem angegebenen Attribut zugeordnet ist.
GetValueBool Gibt einen booleschen Wert aus dem Ziel zurück, das einem angegebenen Attribut zugeordnet ist.
GetValueLongNumber Gibt einen Wert mit langer Zahl aus dem Ziel zurück, das einem angegebenen Attribut zugeordnet ist.
GetValueLongNumbers Gibt eine Auflistung langer Zahlenwerte aus dem Ziel zurück, die einem angegebenen Attribut zugeordnet sind.
GetValueNumber Gibt einen Zahlenwert aus dem Ziel zurück, der einem angegebenen Attribut zugeordnet ist.
GetValueNumbers Gibt eine Auflistung von Zahlenwerten aus dem Ziel zurück, die einem angegebenen Attribut zugeordnet sind.
GetValueString Gibt einen Zeichenfolgenwert aus dem Ziel zurück, der einem angegebenen Attribut zugeordnet ist.
GetValueStrings Gibt eine Auflistung von Zeichenfolgenwerten aus dem Ziel zurück, die einem angegebenen Attribut zugeordnet sind.
HasContext Bestimmt, ob ein bestimmter Kontext für das Ziel vorhanden ist.
HasInterface Bestimmt, ob das Ziel eine bestimmte Schnittstelle unterstützt.
IsEnabled Ruft einen Wert ab, der angibt, ob der EDT-Filtertreiber (Enhanced Device Test) auf dem Zielgerät aktiviert ist.
IsEnabled Erfahren Sie, wie die Methode einen Wert erhält, der angibt, ob der EDT-Filtertreiber (Enhanced Device Test) auf dem Zielgerät aktiviert ist.
IsRebootRequired Ruft einen Wert ab, der angibt, ob der EDT-Filtertreiber (Enhanced Device Test) einen Neustart erfordert.
IsRebootRequired Erfahren Sie, wie die -Methode einen Wert erhält, der angibt, ob der EDT-Filtertreiber (Enhanced Device Test) einen Neustart erfordert.
IsRestartedWithContext Ruft einen Wert ab, der angibt, ob das Testskript für einen bestimmten Kontext neu gestartet wurde.
IsStatusSuccess Ruft einen Wert ab, der angibt, ob der letzte Vorgang erfolgreich war.
Öffnen Öffnet das Gerät.
OutputError Schreibt einen Fehlereintrag in das Testfallprotokoll.
OutputInfo Schreibt einen Informationseintrag in das Testfallprotokoll.
Anhalten Hält die E/A an.
PerformIO Führt eine kleine Menge einfacher E/A-Vorgänge für das Gerät aus.
PowerAnalyzeTraceByFile Analysiert eine Power Trace-Sitzung, die bereits gesammelt und in der zugehörigen Ablaufverfolgungsmeldungsprotokolldatei (ETL) gespeichert wurde. Diese Methode funktioniert nur unter Windows 8 und höher.
PowerTracingEnd Diese Methode beendet eine Power Trace-Sitzung.
PowerTracingStart Startet eine Ablaufverfolgungssitzung für Energiezustandsübergänge und speichert die Ablaufverfolgungsmeldungsdatei (Wdtfpwr.etl) im aktuellen Arbeitsverzeichnis. Diese Methode ist ab Windows 8 verfügbar.
PowerTracingStartByFile Startet eine Ablaufverfolgungssitzung für Energiezustandsübergänge und speichert die Ablaufverfolgungsmeldungsdatei (ETL) unter Verwendung des angegebenen Pfads. Diese Methode ist ab Windows 8 verfügbar.
put_Context Erfahren Sie, wie die Methode ein Name-Wert-Paar abruft und festlegt, das Benutzerdaten für das Ziel darstellt.
put_Critical Legt einen Wert fest oder ruft diesen ab, der angibt, ob der Systemleistungszustand kritisch ist.
put_SkipRestart Legt einen Wert fest, der angibt, ob das Zielgerät standardmäßig neu gestartet werden soll.
put_SkipRestart Erfahren Sie, wie die -Methode einen Wert festlegt, der angibt, ob das Zielgerät standardmäßig neu gestartet werden soll.
put_SleepWakeTimeInSeconds Legt fest oder ruft die Zeit in Sekunden ab, zu der das System aus dem Ruhezustand reaktiviert wird.
Abfrage Gibt eine Teilmenge der Geräte im DeviceDepot zurück.
Abfrage Gibt eine Teilmenge der Elemente in der Auflistung zurück.
QuerySingle Gibt ein einzelnes Zielgerät aus dem DeviceDepot zurück.
QuerySingle Gibt ein einzelnes Element aus der Auflistung zurück.
RebootRestart Starten Sie das System und den aktuellen Test neu.
RebootRestartWithContext Startet das System neu und startet das Testskript mit Kontextdaten neu.
Entfernen Entfernen Sie eine Aktion aus der Auflistung.
Entfernen Entfernt eine lange Zahl aus der Auflistung.
Entfernen Entfernt eine Zahl aus der Auflistung.
Entfernen Entfernt eine Zeichenfolge aus der Auflistung.
Entfernen Entfernt ein Element aus der Auflistung.
RemoveDevice Entfernt das Gerät.
RemoveDevice Erfahren Sie, wie die -Methode das Gerät entfernt.
RequestEjectDevice Initiiert einen Geräteauswurf.
RequestEjectDevice Erfahren Sie, wie die -Methode einen Geräteauswurf initiiert.
RescanDevice Überprüft das Zielgerät erneut.
RescanDevice Erfahren Sie, wie die Methode das Zielgerät erneut einscannt.
RescanParentDevice Überprüft und listet das übergeordnete Gerät des Zielgeräts erneut auf.
RescanParentDevice Erfahren Sie, wie die -Methode das übergeordnete Gerät des Zielgeräts erneut einscannt und erneut aufzählt.
RestartDevice Initiiert einen Geräteneustart.
RestartDevice Erfahren Sie, wie die -Methode einen Geräteneustart initiiert.
SetSimulatedBatteryChargePercentage Legt den Vom simulierten Akku an das Betriebssystem gemeldeten Ladeprozentsatz fest.
SetSimulatedBatteryToAC Legt den simulierten Akku status auf Wechselstrom fest.
SetSimulatedBatteryToDC Legt den simulierten Akku status auf Gleichstrom fest.
SetTarget Die SetTarget-Methode wird intern von WDTF verwendet. Rufen Sie diese Methode nicht direkt auf.
SetTraceLevel Die SetTraceLevel-Methode legt die Ablaufverfolgungsebene für ein -Objekt fest.
Sleep Versetzt das System in den gewünschten Ruhezustand.
Starten Erfahren Sie, wie die -Methode das Gerät öffnet.
StartAsync Signalisiert asynchron das Auftreten eines Startereignisses.
StartTestCase Markiert den Anfang eines Testfalls.
Beenden Beendet das Gerät.
StopAsync Signalisiert asynchron das Auftreten des Stop-Ereignisses.
WaitAsyncCompletion Wartet auf den Abschluss eines der asynchronen Ereignisse.

Schnittstellen

IAction Die IAction-Schnittstellen sind Plug-Ins, die eine instance der IWDTFTarget2-Schnittstelle steuern können.
ITracer Die ITracer-Schnittstelle ermöglicht es einzelnen Instanzen jeder WDTF-Schnittstelle, die spezifischen Ablaufverfolgungseinstellungen für eine bestimmte Implementierungskoklasse zu bestimmen. Diese Einstellungen werden in der Registrierung aufgezeichnet.
ITracing Die ITracing-Schnittstelle legt den TTraceLevel-Wert eines Objekts fest. Diese Schnittstelle ist eine Basisschnittstelle für die meisten WDTF-Schnittstellen.
IWDTF2 Definiert Eigenschaften für die WDTF-Auflistung.
IWDTFAction2 Definiert Vorgänge und Eigenschaften, die eine instance der IWDTFTarget2-Schnittstelle steuern können.
IWDTFActions2 Definiert Vorgänge und Eigenschaften für die Auflistung von Aktionen, die von der IWDTFTargets::GetInterfaces-Methode zurückgegeben werden.
IWDTFCONFIG2 Definiert Vorgänge, die WDTF-Objekte in einem Testskript steuern.
IWDTFDeviceDepot2 Definiert Eigenschaften und Vorgänge für die Sammlung von Geräten auf einem Computer.
IWDTFEnhancedDeviceTestSupportAction2 Definiert Vorgänge und Eigenschaften, die den EDT-Filtertreiber (Enhanced Device Test) unterstützen.
IWDTFEnhancedDeviceTestSupportActions2 Definiert Vorgänge und Eigenschaften, die die Sammlung von EDT-Aktionen (Enhanced Device Test) unterstützen.
IWDTFLOG2 Definiert Vorgänge, die es dem Testfallautor ermöglichen, dem WDTF-Testprotokoll hinzuzufügen.
IWDTFLongNumbers2 Definiert Vorgänge und Eigenschaften für eine Sammlung von langen Zahlen.
IWDTFNumbers2 Definiert Vorgänge und Eigenschaften für eine Auflistung von Zahlen.
IWDTFPNPAction2 Definiert Vorgänge und Eigenschaften für die gerätebezogenen Plug-and-Play-Testschnittstellen (PNP).
IWDTFPNPActions2 Definiert Vorgänge und Eigenschaften für die Sammlung von gerätebezogenen Plug-and-Play-Testschnittstellen (PNP).
IWDTFSimpleIOEx2 Definiert Vorgänge für einen einfachen synchronen E/A-Funktionalitätstest.
IWDTFSimpleIOStressAction2 Definiert Vorgänge für einen einfachen asynchronen E/A-Funktionalitätstest.
IWDTFSimpleIOStressActions2 Definiert Vorgänge für eine Sammlung einfacher asynchroner E/A-Funktionstests.
IWDTFSimulatedBatterySystemAction IWDTFSimulatedBatterySystemAction-Schnittstelle
IWDTFStrings2 Definiert Vorgänge und Eigenschaften für eine Auflistung von Zeichenfolgen.
IWDTFSystemAction2 Definiert Vorgänge und Eigenschaften, die Treibertests unterstützen.
IWDTFSystemDepot2 Definiert Vorgänge und Eigenschaften für den SystemDepot – das Objekt, das den lokalen Computer darstellt.
IWDTFTarget2 Definiert Vorgänge und Eigenschaften für ein testbares Element.
IWDTFTargets2 Definiert Eigenschaften und Vorgänge für die Auflistung.