Windows Device Testing Framework (WDTF)

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

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

• 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 de l’interface ITracer.

Fonctions

Ajouter Ajoutez une seule action à la collection.
Ajouter Ajoute un seul numéro long à la collection.
Ajouter Ajoute un seul nombre à la collection.
Ajouter Ajoute une seule chaîne à la collection.
Ajouter Ajoutez un élément unique à la collection.
Effacer Supprime tous les éléments de la collection.
Effacer Découvrez comment la méthode supprime tous les éléments de la collection.
Fermer Ferme l’appareil.
ConnectedStandby Place le système en état de secours connecté et quitte l’état de secours connecté une fois que l’heure souhaitée est passée. Cette méthode fonctionne uniquement sur un ordinateur qui prend en charge Always On Always Connected (AOAC).
Continue Continue les E/S.
ContinueAsync Signale de façon asynchrone que les E/S continuent.
désactiver Désactive le pilote de filtre EDT (Enhanced Device Test) 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 échoue le 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 échoue le 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 EDT (Enhanced Device Test) sur l’appareil cible.
Activer Découvrez comment la méthode active le pilote de filtre EDT (Enhanced Device Test) 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 utilisée implicitement par la structure de boucles For Each.
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 utilisée implicitement par la structure de boucle For Each.
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 utilisée implicitement par la structure de boucles For Each.
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 de la cible.
get_Count Obtient le nombre d’actions de 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 dans 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 de l’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é suite à 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 dans 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 lorsque le système se réveille 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 à partir duquel provient la cible.
get_WDTF Découvrez comment cette propriété obtient l’objet d’agrégation WDTF principal.
get_WDTF Cette propriété obtient l’objet d’agrégation WDTF principal.
get_WDTF Cette méthode obtient l’objet d’agrégation WDTF principal.
get_WDTF Découvrez comment cette méthode obtient l’objet d’agrégation WDTF principal.
GetBits La méthode GetBits retourne l’ensemble d’indicateurs de suivi pour 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 un.
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 un.
GetNextSleepState Retourne l’état de veille suivant pris en charge.
GetRelations Retourne une collection de cibles associées.
getStatus Retourne le code d’état de la dernière opération.
GetStatusString Retourne l’état 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 à partir de la cible associée à un attribut spécifié.
GetValueLongNumber Retourne une valeur de nombre long à partir de la cible associée à un attribut spécifié.
GetValueLongNumbers Retourne une collection de valeurs de nombre long à partir de la cible associée à 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 à partir de la cible associée à un attribut spécifié.
GetValueString Retourne une valeur de chaîne à partir de la cible associée à un attribut spécifié.
GetValueStrings Retourne une collection de valeurs de chaîne à partir de la cible associée à 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.
EstActivé Obtient une valeur qui indique si le pilote de filtre EDT (Enhanced Device Test) est activé sur l’appareil cible.
EstActivé Découvrez comment la méthode obtient une valeur qui indique si le pilote de filtre EDT (Enhanced Device Test) 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.
Suspendre Suspend 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 du 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 trace 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 trace pour les transitions d’état d’alimentation et enregistre le fichier de message de trace (.etl) à l’aide du chemin 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 de la cible.
put_Critical Définit ou obtient une valeur qui indique si l’état de l’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 lorsque le système se réveille à partir 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 élément unique de la collection.
rebootRestart Redémarrez le système et le test actuel.
RebootRestartWithContext Redémarre le système et redémarre le script de test avec des données contextuelles.
Supprimer Supprimez une action de la collection.
Supprimer Supprime un nombre long de la collection.
Supprimer Supprime un nombre de la collection.
Supprimer Supprime une chaîne de la collection.
Supprimer 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 Analyse à nouveau 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 ré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 d’appareil.
SetSimulatedBatteryChargePercentage Définit le pourcentage de charge signalé au système d’exploitation par la batterie simulée.
SetSimulatedBatteryToAC Définit l’état de la batterie simulée sur l’alimentation ac.
SetSimulatedBatteryToDC Définit l’état de la batterie simulée sur l’alimentation du contrôleur de domaine.
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é.
Démarrer Découvrez comment la méthode ouvre l’appareil.
StartAsync Signale de façon asynchrone qu’un événement de démarrage se produit.
StartTestCase Marque le début d’un cas de test.
Arrêter Arrête l’appareil.
stopAsync Signale de façon asynchrone l’événement d’arrêt à se produire.
WaitAsyncCompletion Attend la fin de l’un des événements asynchrones.

Interfaces

IAction Les interfaces IAction sont des plug-ins qui peuvent contrôler une instance de l’interface IWDTFTarget2.
ITracer L’interface ITracer permet aux instances individuelles de chaque interface WDTF de déterminer les paramètres de suivi spécifiques d’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 des opérations et des propriétés qui peuvent contrôler une instance de l’interface IWDTFTarget2.
IWDTFActions2 Définit les opérations et les propriétés de la collection d’actions retournées par la méthode IWDTFTFTargets ::GetInterfaces.
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 collecte d’actions EDT (Enhanced Device Test).
IWDTFLOG2 Définit les opérations qui permettent à l’auteur de cas de test d’ajouter au journal de test WDTF.
IWDTFLongNumbers2 Définit des opérations et des propriétés pour une collection de nombres longs.
IWDTFNumbers2 Définit des opérations et des propriétés pour une collection de nombres.
IWDTFPNPAction2 Définit des opérations et des propriétés pour les interfaces de test liées aux appareils Plug-and-Play (PNP).
IWDTFPNPActions2 Définit des opérations et des 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 simple des fonctionnalités d’E/S asynchrones.
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.