Windows Device Testing Framework (WDTF)

Vue d’ensemble de la technologie Windows Device Testing Framework (WDTF).

Pour développer Windows Device Testing Framework (WDTF), vous avez besoin des en-têtes suivants :

• 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

Pour obtenir le guide de programmation, consultez Windows Device Testing Framework (WDTF).

Énumérations

TTraceLevel L’énumération TTraceLevel définit un ensemble de niveaux pour le suivi dans WDTF. La signification de chaque niveau dépend des paramètres de Registre pour l’interface ITracer.

Fonctions

Ajouter Ajoutez une action unique à la collection.
Ajouter Ajoute un seul nombre long à la collection.
Ajouter Ajoute un seul nombre à la collection.
Ajouter Ajoute une seule chaîne à la collection.
Ajouter Ajoutez un seul élément à la collection.
Clear Supprime tous les éléments de la collection.
Clear Découvrez comment la méthode supprime tous les éléments de la collection.
Close Ferme l’appareil.
ConnectedStandby Place le système dans l’état Veille connectée et quitte l’état Veille connectée une fois le temps souhaité écoulé. Cette méthode fonctionne uniquement sur un ordinateur qui prend en charge Always On Always Connected (AOAC).
Continuer Continue les E/S.
ContinueAsync Signale de façon asynchrone que les E/S continuent.
Désactiver Désactive le pilote de filtre test d’appareil amélioré (EDT) sur l’appareil cible.
Désactiver Découvrez comment la méthode désactive le pilote de filtre EDT (Enhanced Device Test) sur l’appareil cible.
DisableDevice Désactive l’appareil cible.
DisableDevice Découvrez comment la méthode désactive l’appareil cible.
DisableObjectErrorLogging Désactive la journalisation des erreurs d’objet pour l’action.
DisableObjectErrorLogging Désactivez la journalisation des erreurs d’objet pour toutes les actions de la collection.
DisableObjectErrorLogging Désactive la journalisation des erreurs d’objet pour tous les objets.
DisableObjectLogging Désactive la journalisation des objets pour l’action.
DisableObjectLogging Désactivez la journalisation des objets pour toutes les actions de la collection.
DisableObjectLogging Désactive la journalisation des objets pour tous les objets.
DisableRealBatteries Désactive les piles réelles si elles sont présentes dans le système.
DisableSimulatedBattery Désactive la batterie simulée.
EDTCancelRemoveDevice Envoie un événement IRP_MN_CANCEL_REMOVE_DEVICE à l’appareil cible.
EDTCancelRemoveDevice Découvrez comment la méthode envoie un événement IRP_MN_CANCEL_REMOVE_DEVICE à l’appareil cible.
EDTCancelStopDevice Envoie un événement IRP_MN_CANCEL_STOP_DEVICE à l’appareil cible.
EDTCancelStopDevice Découvrez comment la méthode envoie un événement IRP_MN_CANCEL_STOP_DEVICE à l’appareil cible.
EDTSurpriseRemoveDevice Envoie un événement IRP_MN_SURPRISE_REMOVAL à l’appareil cible.
EDTSurpriseRemoveDevice Découvrez comment la méthode envoie un événement IRP_MN_SURPRISE_REMOVAL à l’appareil cible.
EDTTryStopDevice Tente d’envoyer un événement IRP_MN_STOP_DEVICE à l’appareil cible.
EDTTryStopDevice Découvrez comment la méthode tente d’envoyer un événement IRP_MN_STOP_DEVICE à l’appareil cible.
EDTTryStopDeviceFailRestart Cette méthode tente d’envoyer un événement IRP_MN_STOP_DEVICE à l’appareil cible, puis d’échouer au redémarrage de l’appareil suivant.
EDTTryStopDeviceFailRestart Découvrez comment la méthode EDTTryStopDeviceFailRestart tente d’envoyer un événement IRP_MN_STOP_DEVICE à l’appareil cible, puis d’échouer au redémarrage de l’appareil suivant.
EDTTryStopDeviceRequestNewResources Tente d’envoyer un événement IRP_MN_STOP_DEVICE à l’appareil cible et d’affecter de nouvelles ressources à l’appareil cible.
EDTTryStopDeviceRequestNewResources Découvrez comment la méthode tente d’envoyer un événement IRP_MN_STOP_DEVICE à l’appareil cible et d’affecter de nouvelles ressources à l’appareil cible.
Activer Active le pilote de filtre test d’appareil amélioré (EDT) sur l’appareil cible.
Activer Découvrez comment la méthode active le pilote de filtre test d’appareil amélioré (EDT) sur l’appareil cible.
EnableDevice Active l’appareil cible.
EnableDevice Découvrez comment la méthode active l’appareil cible.
EnableObjectErrorLogging Active la journalisation des erreurs d’objet pour l’action.
EnableObjectErrorLogging Activez la journalisation des erreurs d’objet pour toutes les actions de la collection.
EnableObjectErrorLogging Active la journalisation des erreurs d’objet pour tous les objets.
EnableObjectLogging Active la journalisation des objets pour l’action.
EnableObjectLogging Activez la journalisation des objets pour toutes les actions de la collection.
EnableObjectLogging Active la journalisation des objets pour tous les objets.
EnableRealBatteries Active les piles réelles si elles sont présentes dans le système.
EnableSimulatedBattery Active la batterie simulée.
EndTestCase Marque la fin d’un cas de test.
Eval Évaluez si cette cible correspond à une instruction SDEL.
Eval Évalue si tous les éléments de la collection correspondent à une instruction SDEL.
get__NewEnum Obtient une nouvelle variable d’itération que la structure de boucle For Each utilise implicitement.
get__NewEnum Découvrez comment cette méthode d’interface IWDTFDeviceDepot2 obtient une nouvelle variable d’itération que la structure de boucle For Each utilise implicitement.
get__NewEnum Découvrez comment la méthode get__NewEnum de l’interface IWDTFLongNumbers2 obtient une nouvelle variable d’itération que la structure de boucle For Each utilise implicitement.
get__NewEnum La méthode get__NewEnum obtient une nouvelle variable d’itération que la structure de boucle For Each utilise implicitement.
get__NewEnum Découvrez comment la méthode get__NewEnum de l’interface IWDTFStrings2 obtient une nouvelle variable d’itération que la structure de boucle For Each utilise implicitement.
get__NewEnum Découvrez comment cette méthode d’interface IWDTFTargets2 obtient une nouvelle variable d’itération que la structure de boucle For Each utilise implicitement.
get_Config Obtient l’objet de configuration WDTF.
get_Context Obtient et définit une paire nom-valeur qui représente les données utilisateur pour la cible.
get_Count Obtient le nombre d’actions dans cette collection.
get_Count Obtient le nombre d’appareils actuellement fournis par DeviceDepot.
get_Count Obtient le nombre de nombres longs dans la collection.
get_Count Obtient le nombre de nombres dans la collection.
get_Count Obtient le nombre de chaînes de la collection.
get_Count Obtient le nombre d’éléments de cette collection.
get_Critical Obtient ou définit une valeur qui indique si l’état d’alimentation du système est critique.
get_DeviceDepot Obtient l’objet DeviceDepot.
get_IsRestarted Obtient une valeur qui indique si le script de test a redémarré à la suite d’un appel à RebootRestart ou RebootRestartWithContext.
get_Item Obtient une action individuelle dans la collection.
get_Item Obtient un appareil individuel dans DeviceDepot.
get_Item Obtient un nombre long individuel dans la collection.
get_Item Obtient un nombre individuel dans la collection.
get_Item Obtient une chaîne individuelle dans la collection.
get_Item Obtient un élément individuel de la collection.
get_Log Obtient l’objet journal WDTF.
get_RootDevice Obtient l’appareil racine.
get_SleepWakeTimeInSeconds Obtient ou définit l’heure, en secondes, pendant laquelle le système sortira de l’état de veille.
get_SystemDepot Obtient l’objet SystemDepot.
get_Target Obtient la cible à laquelle cette action fait référence.
get_ThisSystem Obtient une valeur IWDTFTarget2 qui représente l’ordinateur local.
get_Type Obtient une valeur qui identifie le dépôt d’où provient la cible.
get_WDTF Découvrez comment cette propriété obtient l’objet d’agrégation WDTF main.
get_WDTF Cette propriété obtient le main objet d’agrégation WDTF.
get_WDTF Cette méthode obtient l’objet d’agrégation WDTF main.
get_WDTF Découvrez comment cette méthode obtient le main objet d’agrégation WDTF.
GetBits La méthode GetBits retourne l’ensemble des indicateurs de suivi d’une coclasse en tant que masque de bits, en fonction d’une valeur TTraceLevel spécifiée et du CLSID de la coclasse.
GetFirstSleepState Retourne le premier état de veille pris en charge.
GetInterface Retourne une action pour la cible.
GetInterfaces Retourne une collection d’actions qui prennent en charge l’interface : une IWDTFAction2 pour chaque élément qui en a une.
GetInterfacesIfExist Découvrez comment la méthode retourne une collection d’actions qui prennent en charge l’interface : une IWDTFAction2 pour chaque élément qui en a une.
GetNextSleepState Retourne l’état de veille suivant pris en charge.
GetRelations Retourne une collection de cibles associées.
GetStatus Retourne le code status de la dernière opération.
GetStatusString Retourne le status de la dernière opération sous forme de chaîne.
GetValue Retourne une valeur de la cible associée à un attribut spécifié.
GetValueBool Retourne une valeur booléenne de la cible associée à un attribut spécifié.
GetValueLongNumber Retourne une valeur de nombre long de la cible associée à un attribut spécifié.
GetValueLongNumbers Retourne une collection de valeurs de nombre long de la cible associées à un attribut spécifié.
GetValueNumber Retourne une valeur numérique de la cible associée à un attribut spécifié.
GetValueNumbers Retourne une collection de valeurs numériques de la cible associées à un attribut spécifié.
GetValueString Retourne une valeur de chaîne de la cible associée à un attribut spécifié.
GetValueStrings Retourne une collection de valeurs de chaîne de la cible associées à un attribut spécifié.
HasContext Détermine si un contexte donné existe pour la cible.
HasInterface Détermine si la cible prend en charge une interface donnée.
IsEnabled Obtient une valeur qui indique si le pilote de filtre test d’appareil amélioré (EDT) est activé sur l’appareil cible.
IsEnabled Découvrez comment la méthode obtient une valeur qui indique si le pilote de filtre test d’appareil amélioré (EDT) est activé sur l’appareil cible.
IsRebootRequired Obtient une valeur qui indique si le pilote de filtre EDT (Enhanced Device Test) nécessite un redémarrage.
IsRebootRequired Découvrez comment la méthode obtient une valeur qui indique si le pilote de filtre EDT (Enhanced Device Test) nécessite un redémarrage.
IsRestartedWithContext Obtient une valeur qui indique si le script de test a été redémarré pour un contexte spécifique.
IsStatusSuccess Obtient une valeur qui indique si la dernière opération a réussi.
Ouvrir Ouvre l’appareil.
OutputError Écrit une entrée d’erreur dans le journal des cas de test.
OutputInfo Écrit une entrée d’information dans le journal des cas de test.
Pause Interrompt les E/S.
PerformIO Effectue une petite quantité d’E/S simples sur l’appareil.
PowerAnalyzeTraceByFile Analyse une session de suivi de l’alimentation qui a déjà été collectée et stockée dans le fichier journal de message de trace (.etl) associé. Cette méthode fonctionne uniquement sur Windows 8 et versions ultérieures.
PowerTracingEnd Cette méthode met fin à une session de suivi de l’alimentation.
PowerTracingStart Démarre une session de suivi pour les transitions d’état d’alimentation et enregistre le fichier de message de trace (Wdtfpwr.etl) dans le répertoire de travail actuel. Cette méthode est disponible à partir de Windows 8.
PowerTracingStartByFile Démarre une session de suivi pour les transitions d’état d’alimentation et enregistre le fichier de message de trace (.etl) à l’aide du chemin d’accès spécifié. Cette méthode est disponible à partir de Windows 8.
put_Context Découvrez comment la méthode obtient et définit une paire nom-valeur qui représente les données utilisateur pour la cible.
put_Critical Définit ou obtient une valeur qui indique si l’état d’alimentation du système est critique.
put_SkipRestart Définit une valeur qui indique si l’appareil cible doit être redémarré par défaut.
put_SkipRestart Découvrez comment la méthode définit une valeur qui indique si l’appareil cible doit être redémarré par défaut.
put_SleepWakeTimeInSeconds Définit ou obtient l’heure, en secondes, pendant laquelle le système sortira de l’état de veille.
Requête Retourne un sous-ensemble des appareils dans DeviceDepot.
Requête Retourne un sous-ensemble des éléments de la collection.
QuerySingle Retourne un appareil cible unique à partir de DeviceDepot.
QuerySingle Retourne un seul élément de la collection.
RebootRestart Redémarrez le système et le test en cours.
RebootRestartWithContext Redémarre le système et redémarre le script de test avec des données de contexte.
Remove Supprimer une action de la collection.
Remove Supprime un nombre long de la collection.
Remove Supprime un nombre de la collection.
Remove Supprime une chaîne de la collection.
Remove Supprime un élément de la collection.
RemoveDevice Supprime l’appareil.
RemoveDevice Découvrez comment la méthode supprime l’appareil.
RequestEjectDevice Lance un éjection d’appareil.
RequestEjectDevice Découvrez comment la méthode lance un éjection d’appareil.
RescanDevice Réanalyse l’appareil cible.
RescanDevice Découvrez comment la méthode réanalyse l’appareil cible.
RescanParentDevice Réanalyse et énumère à nouveau l’appareil parent de l’appareil cible.
RescanParentDevice Découvrez comment la méthode analyse et énumère à nouveau l’appareil parent de l’appareil cible.
RestartDevice Lance un redémarrage de l’appareil.
RestartDevice Découvrez comment la méthode lance un redémarrage de l’appareil.
SetSimulatedBatteryChargePercentage Définit le pourcentage de charge signalé au système d’exploitation par la batterie simulée.
SetSimulatedBatteryToAC Définit l’status de la batterie simulée sur l’alimentation secteur.
SetSimulatedBatteryToDC Définit l’status de la batterie simulée sur l’alimentation DC.
SetTarget La méthode SetTarget est utilisée en interne par WDTF. N'appelez pas cette méthode directement.
SetTraceLevel La méthode SetTraceLevel définit le niveau de suivi d’un objet.
Veille Place le système dans l’état de veille souhaité.
Start Découvrez comment la méthode ouvre l’appareil.
StartAsync Signale de manière asynchrone qu’un événement de démarrage se produit.
StartTestCase Marque le début d’un cas de test.
Stop Arrête l’appareil.
StopAsync Signale de manière asynchrone que l’événement d’arrêt se produit.
WaitAsyncCompletion Attend la fin de l’un des événements asynchrones.

Interfaces

IAction Les interfaces IAction sont des plug-ins qui peuvent contrôler un instance de l’interface IWDTFTarget2.
ITracer L’interface ITracer permet à des instances individuelles de chaque interface WDTF de déterminer les paramètres de suivi spécifiques pour une coclasse d’implémentation donnée. Ces paramètres sont enregistrés dans le Registre.
ITracing L’interface ITracing définit la valeur TTraceLevel d’un objet. Cette interface est une interface de base pour la plupart des interfaces WDTF.
IWDTF2 Définit les propriétés de la collection WDTF.
IWDTFAction2 Définit les opérations et les propriétés qui peuvent contrôler un instance de l’interface IWDTFTarget2.
IWDTFActions2 Définit les opérations et les propriétés pour la collection d’actions que la méthode IWDTFTargets::GetInterfaces retourne.
IWDTFCONFIG2 Définit les opérations qui contrôlent les objets WDTF dans un script de test.
IWDTFDeviceDepot2 Définit les propriétés et les opérations pour la collection d’appareils sur un ordinateur.
IWDTFEnhancedDeviceTestSupportAction2 Définit les opérations et les propriétés qui prennent en charge le pilote de filtre EDT (Enhanced Device Test).
IWDTFEnhancedDeviceTestSupportActions2 Définit les opérations et les propriétés qui prennent en charge la collection d’actions de test d’appareil amélioré (EDT).
IWDTFLOG2 Définit les opérations qui permettent à l’auteur de cas de test d’ajouter au journal de test WDTF.
IWDTFLongNumbers2 Définit les opérations et les propriétés d’une collection de nombres longs.
IWDTFNumbers2 Définit les opérations et les propriétés d’une collection de nombres.
IWDTFPNPAction2 Définit les opérations et les propriétés pour les interfaces de test liées aux appareils Plug-and-Play (PNP).
IWDTFPNPActions2 Définit les opérations et les propriétés pour la collection d’interfaces de test liées aux appareils Plug-and-Play (PNP).
IWDTFSimpleIOEx2 Définit des opérations pour un test de fonctionnalité d’E/S synchrone simple.
IWDTFSimpleIOStressAction2 Définit des opérations pour un test de fonctionnalité d’E/S asynchrone simple.
IWDTFSimpleIOStressActions2 Définit des opérations pour une collection de tests de fonctionnalités d’E/S asynchrones simples.
IWDTFSimulatedBatterySystemAction IWDTFSimulatedBatterySystemAction, interface
IWDTFStrings2 Définit des opérations et des propriétés pour une collection de chaînes.
IWDTFSystemAction2 Définit les opérations et les propriétés qui prennent en charge les tests de pilotes.
IWDTFSystemDepot2 Définit des opérations et des propriétés pour SystemDepot , l’objet qui représente l’ordinateur local.
IWDTFTarget2 Définit les opérations et les propriétés d’un élément testable.
IWDTFTargets2 Définit les propriétés et les opérations de la collection.