Partager via


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.