Windows Device Testing Framework (WDTF)

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

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 Registrierungseinstellungen für die ITracer-Schnittstelle ab.

Funktionen


Hinzufügen von Fügen Sie der Auflistung eine einzelne Aktion hinzu.
Hinzufügen von Fügt der Auflistung eine einzelne lange Zahl hinzu.
Hinzufügen von Fügt der Auflistung eine einzelne Zahl hinzu.
Hinzufügen von Fügt der Auflistung eine einzelne Zeichenfolge hinzu.
Hinzufügen von Fügen Sie der Auflistung ein einzelnes Element hinzu.
löschen Entfernt alle Elemente aus der Auflistung.
löschen 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 vergangen ist. Diese Methode funktioniert nur auf einem Computer, der Always On Always Connected (AOAC) unterstützt.
fortsetzen Setzt die E/A fort.
ContinueAsync- Signalisiert asynchron, dass der E/A-Vorgang 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.
EDTCancelStopDevice 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 Neustart des Geräts 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.
EDTTryStopDeviceReviceRequestNewResources Versucht, ein IRP_MN_STOP_DEVICE-Ereignis an das Zielgerät zu senden und dem Zielgerät neue Ressourcen zuzuweisen.
EDTTryStopDeviceReviceRequestNewResources 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 der 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- Ermöglicht 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 einer SDEL-Anweisung entspricht.
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 abruft, 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 die For Each-Schleifenstruktur implizit verwendet.
get_Config Ruft das WDTF-Konfigurationsobjekt ab.
get_Context Ruft ein Name-Wert-Paar ab, das Benutzerdaten für das Ziel darstellt, und legt dieses 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 Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Systemleistungszustand kritisch ist.
get_DeviceDepot Ruft das DeviceDepot -Objekt ab.
get_IsRestarted Ruft einen Wert ab, der angibt, ob das Testskript aufgrund 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 aktiviert wird, oder legt sie 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, der den lokalen Computer darstellt.
get_Type Ruft einen Wert ab, der das Depot angibt, von dem das Ziel stammt.
get_WDTF Erfahren Sie, wie diese Eigenschaft das Haupt-WDTF-Aggregationsobjekt abruft.
get_WDTF Diese Eigenschaft ruft das Haupt-WDTF-Aggregationsobjekt ab.
get_WDTF Diese Methode ruft das Haupt-WDTF-Aggregationsobjekt ab.
get_WDTF Erfahren Sie, wie diese Methode das Haupt-WDTF-Aggregationsobjekt abruft.
GetBits- Die GetBits-Methode gibt den Satz von Ablaufverfolgungskennzeichnungen für eine Coclass als Bitmaske zurück, wobei ein angegebener TTraceLevel-Wert und die CLSID der Coclass angegeben ist.
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 über eins verfügt.
GetInterfacesIfExist Erfahren Sie, wie die Methode eine Sammlung von Aktionen zurückgibt, die die Schnittstelle unterstützen – ein IWDTFAction2 für jedes Element, das über ein Element verfügt.
GetNextSleepState- Gibt den nächsten unterstützten Ruhezustand zurück.
GetRelations- Gibt eine Auflistung verwandter Ziele zurück.
GetStatus- Gibt den Statuscode 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, das einem angegebenen Attribut zugeordnet ist.
GetValueBool- Gibt einen booleschen Wert aus dem Ziel zurück, das einem angegebenen Attribut zugeordnet ist.
GetValueLongNumber- Gibt einen langen Zahlenwert 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, das 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, das 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 abruft, 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 abruft, 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 auf dem Gerät aus.
PowerAnalyzeTraceByFile- Analysiert eine Power Trace-Sitzung, die bereits gesammelt und in der zugehörigen Ablaufverfolgungsprotokolldatei (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) mithilfe 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, der angibt, ob der Systemleistungszustand kritisch ist, oder ruft diesen wert ab.
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 die Zeit in Sekunden fest oder ruft sie ab, wenn das System aus dem Ruhezustand aktiviert 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äteausstoß.
RequestEjectDevice Erfahren Sie, wie die Methode einen Geräteausstoß initiiert.
RescanDevice- Überprüft das Zielgerät erneut.
RescanDevice- Erfahren Sie, wie die Methode das Zielgerät erneut überprüft.
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 überprüft und erneut aufzählt.
RestartDevice- Initiiert einen Geräteneustart.
RestartDevice- Erfahren Sie, wie die Methode einen Geräteneustart initiiert.
SetSimulatedBatteryChargePercentage Legt den Prozentsatz der Ladung fest, der vom simulierten Akku an das Betriebssystem gemeldet wird.
SetSimulatedBatteryToAC- Legt den simulierten Akkustatus auf Netzstrom fest.
SetSimulatedBatteryToDC- Legt den simulierten Akkustatus auf dc power 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 ein Startereignis.
StartTestCase- Markiert den Anfang eines Testfalls.
beenden Beendet das Gerät.
StopAsync- Signalisiert asynchron, dass das Stoppereignis eintritt.
WaitAsyncCompletion- Wartet auf den Abschluss eines der asynchronen Ereignisse.

Schnittstellen


IAction- Die IAction-Schnittstellen sind Plug-Ins, die eine Instanz 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 Implementierungs coclass 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 Instanz 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 erweiterter Gerätetestaktionen (Enhanced Device Test, EDT) unterstützen.
IWDTFLOG2 Definiert Vorgänge, mit denen der Testfallautor dem WDTF-Testprotokoll hinzugefügt werden kann.
IWDTFLongNumbers2 Definiert Vorgänge und Eigenschaften für eine Auflistung langer Zahlen.
IWDTFNumbers2 Definiert Vorgänge und Eigenschaften für eine Auflistung von Zahlen.
IWDTFPNPAction2 Definiert Vorgänge und Eigenschaften für die Plug and Play-Schnittstellen (Plug and Play, PNP) für gerätebezogene Testschnittstellen.
IWDTFPNPActions2 Definiert Vorgänge und Eigenschaften für die Sammlung von Plug and Play (PNP)-gerätebezogenen Testschnittstellen.
IWDTFSimpleIOEx2 Definiert Vorgänge für einen einfachen synchronen E/A-Funktionstest.
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-Funktionalitätstests.
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 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.

Feedback

War diese Seite hilfreich?

Last updated on 2025-03-22