Outils de test de pilotes

Vue d’ensemble de la technologie des outils de test de pilote.

Pour développer des outils de test de pilote, vous avez besoin de ces en-têtes :

wpprecorder.h

Pour obtenir le guide de programmation, consultez Outils de test de pilotes.

Macros

Titre	Description
macro WppRecorderConfigure	La méthode WppRecorderConfigure active ou désactive le journal par défaut sur lequel WPP imprime.
macro WppRecorderDumpLiveDriverData	La méthode WppRecorderDumpLiveDriverData obtient la mémoire tampon associée au journal de l’enregistreur de trace inflight spécifié.
macro WppRecorderGetTriageInfo	The WppRecorderGetTriageInfo.
macro WppRecorderLinkCounters	The WppRecorderLinkCounters.
macro WppRecorderLogCreate	La méthode WppRecorderLogCreate crée une mémoire tampon pour contenir le journal de l’enregistreur.
macro WppRecorderLogDelete	La méthode WppRecorderLogDelete supprime le journal de l’enregistreur spécifié.
macro WppRecorderLogSetIdentifier	La méthode WppRecorderLogSetIdentifier définit un identificateur de chaîne pour le journal de l’enregistreur.

Énumérations


FAULT_INFORMATION_ARCH Définit des valeurs pour le type d’architecture système.
FAULT_INFORMATION_ARM64_TYPE Définit des valeurs pour le type d’erreur.
PCW_CALLBACK_TYPE L’énumération PCW_CALLBACK_TYPE définit le type de notification à envoyer au fournisseur inscrit du compteur. Un fournisseur transmet un pointeur à cette énumération en tant que paramètre à la fonction PcwCallback.
WPP_RECORDER_TRI_STATE Le type d’énumération WPP_RECORDER_TRI_STATE définit trois valeurs que WPP utilise pour certains membres de structure et paramètres de fonction.

Fonctions


ASSERTMSG ASSERTMSG teste une expression. Si l’expression est false, elle se décompose dans le débogueur du noyau et l’envoie au message spécifié.
dbgBreakPoint La routine DbgBreakPoint se décompose dans le débogueur du noyau.
DbgBreakPointWithStatus La routine DbgBreakPointWithStatus se décompose dans le débogueur du noyau et envoie la valeur Status au débogueur.
dbgPrint La routine DbgPrint envoie un message au débogueur du noyau.
dbgPrintEx La routine DbgPrintEx envoie une chaîne au débogueur du noyau si les conditions que vous spécifiez sont remplies.
dbgPrompt La routine DbgPrompt affiche une chaîne d’invite utilisateur spécifiée par l’appelant sur l’appareil d’affichage du débogueur du noyau et obtient une chaîne de réponse utilisateur.
EtwActivityIdControl La fonction EtwActivityIdControl crée, interroge et définit l’identificateur d’activité actuel.
ETWENABLECALLBACK La fonction EtwEnableCallback est une fonction de rappel facultative fournie par le pilote utilisée pour recevoir des notifications d’activation ou de désactivation.
EtwEventEnabled La fonction EtwEventEnabled vérifie si un événement est activé.
EtwProviderEnabled La fonction EtwProviderEnabled vérifie qu’un fournisseur est activé pour la journalisation des événements à un niveau et un mot clé spécifiés.
EtwRegister La fonction EtwRegister inscrit le fournisseur d’événements et doit être appelée pour qu’un fournisseur puisse démarrer le suivi.
EtwUnregister La fonction EtwUnregister annule l’inscription du fournisseur d’événements et doit être appelée avant la sortie du fournisseur.
EtwWrite La fonction EtwWrite est une fonction de suivi pour la publication d’événements dans votre code de pilote en mode noyau.
EtwWriteEx La fonction EtwWriteEx est une fonction de suivi pour la publication d’événements qui prennent en charge le filtrage dans votre code de pilote en mode noyau.
EtwWriteString La fonction EventWriteString est une fonction de suivi que vous pouvez utiliser lorsqu’aucune donnée sophistiquée n’est requise. Cette fonction est similaire à une instruction d’impression de débogage.
EtwWriteTransfer La fonction EtwWriteTransfer marque un événement qui lie deux activités ensemble ; ce type d’événement est appelé événement de transfert.
imp_WppRecorderGetCounterHandle Méthode WppRecorderGetCounterHandle.
imp_WppRecorderIsDefaultLogAvailable La méthode WppRecorderIsDefaultLogAvailable détermine si le journal par défaut est disponible.
imp_WppRecorderLogGetDefault La méthode WppRecorderLogGetDefault obtient un handle dans le journal de l’enregistreur par défaut.
KdBreakPointWithStatus La macro KdBreakPointWithStatus se décompose dans le débogueur du noyau et envoie la valeur status au débogueur.
KdChangeOption La routine KdChangeOption accède et modifie l’état dans le noyau lié au débogage du noyau.
KdDisableDebugger La routine KdDisableDebugger désactive le débogueur du noyau.
KdEnableDebugger La routine KdEnableDebugger réactive le débogueur du noyau après un appel à la routine KdDisableDebugger désactive le débogueur du noyau.
KdPrint La macro KdPrint envoie un message au débogueur du noyau.
KdPrintEx La macro KdPrintEx envoie une chaîne au débogueur du noyau si les conditions que vous spécifiez sont remplies. Un appel à KdPrintEx nécessite deux parenthèses.
KdRefreshDebuggerNotPresent La macro KdRefreshDebuggerNotPresent actualise la valeur de la variable de noyau globale KD_DEBUGGER_NOT_PRESENT.
KeInitializeTriageDumpDataArray Initialise un tableau de blocs de données de vidage triage.
PCW_CALLBACK Les fournisseurs peuvent implémenter une fonction PCW_CALLBACK pour recevoir des notifications lorsque les consommateurs effectuent certaines actions, telles que l’ajout ou la suppression de compteurs d’une requête.
PcwAddInstance La fonction PcwAddInstance ajoute l’instance spécifiée du compteur à la mémoire tampon du consommateur.
PcwCloseInstance La fonction PcwCloseInstance ferme l’instance spécifiée du compteur.
PcwCreateInstance La fonction PcwCreateInstance crée une instance pour le compteur inscrit spécifié.
PcwRegister La fonction PcwRegister inscrit l’appelant en tant que fournisseur du compteur spécifié.
PcwUnregister La fonction PcwUnregister annule l’inscription du fournisseur du compteur spécifié.
RECORDER_CONFIGURE_PARAMS_INIT La fonction RECORDER_CONFIGURE_PARAMS_INIT est utilisée pour initialiser la structure RECORDER_CONFIGURE_PARAMS.
RECORDER_LOG_CREATE_PARAMS_INIT La fonction RECORDER_LOG_CREATE_PARAMS_INIT est utilisée pour initialiser la structure RECORDER_LOG_CREATE_PARAMS.
RECORDER_LOG_CREATE_PARAMS_INIT_APPEND_POINTER La méthode RECORDER_LOG_CREATE_PARAMS_INIT_APPEND_POINTER initialise le RECORDER_LOG_CREATE_PARAMS avec le pointeur pour lier les journaux.
SeEtwWriteKMCveEvent La fonction SeEtwWriteKMCveEvent est une fonction de suivi pour la publication d’événements lorsqu’une tentative d’exploitation des vulnérabilités de sécurité est détectée dans vos pilotes en mode noyau.
vDbgPrintEx La routine vDbgPrintEx envoie une chaîne au débogueur du noyau si certaines conditions sont remplies.
vDbgPrintExWithPrefix La routine vDbgPrintExWithPrefix envoie une chaîne au débogueur du noyau si certaines conditions que vous spécifiez sont remplies. Cette routine peut ajouter un préfixe à la sortie du débogueur pour faciliter l’organisation des résultats du débogage.
WppRecorderConfigure Découvrez comment la méthode WppRecorderConfigure active ou désactive le journal par défaut sur lequel WPP imprime.
WppRecorderDumpLiveDriverData Découvrez comment la méthode WppRecorderDumpLiveDriverData obtient la mémoire tampon associée au journal d’enregistreur de trace inflight spécifié.
WppRecorderGetTriageInfo Découvrez la méthode WppRecorderGetTriageInfo.
WppRecorderLinkCounters Découvrez comment la méthode WppRecorderLinkCounters utilise un numéro de séquence pour fusionner les journaux capturés dans différentes mémoires tampons par un pilote.
WppRecorderLogCreate Découvrez comment la méthode WppRecorderLogCreate crée une mémoire tampon pour contenir le journal de l’enregistreur.
WppRecorderLogDelete Découvrez comment la méthode WppRecorderLogDelete supprime le journal de l’enregistreur spécifié.
WppRecorderLogDumpLiveData La méthode WppRecorderLogDumpLiveData retourne un pointeur opaque vers un en-tête de mémoire tampon de journal et des données afin qu’elles puissent être enregistrées dans un crashdump en direct.
WppRecorderLogSetIdentifier Découvrez comment la méthode WppRecorderLogSetIdentifier définit un identificateur de chaîne pour le journal de l’enregistreur.

Structures


DEBUG_DEVICE_DESCRIPTOR En savoir plus sur les alertes suivantes : structure DEBUG_DEVICE_DESCRIPTOR
DEBUG_TRANSPORT_DATA Décrit les données spécifiques au transport de débogage à utiliser par le transport.
FAULT_INFORMATION Contient des informations pour définir le rapport d’erreur sur un appareil.
FAULT_INFORMATION_ARM64 Contient des informations d’erreur pour un système ARM64.
FAULT_INFORMATION_ARM64_FLAGS Définit les informations d’erreur.
KBUGCHECK_CALLBACK_RECORD En savoir plus sur les alertes suivantes : structure de KBUGCHECK_CALLBACK_RECORD
KBUGCHECK_REASON_CALLBACK_RECORD En savoir plus sur les alertes suivantes : structure KBUGCHECK_REASON_CALLBACK_RECORD
KBUGCHECK_REMOVE_PAGES Décrit une ou plusieurs pages de données fournies par le pilote à supprimer du fichier de vidage sur incident par une routine de rappel KBUGCHECK_REASON_CALLBACK_ROUTINE.
KBUGCHECK_SECONDARY_DUMP_DATA_EX En savoir plus sur les alertes suivantes : structure _KBUGCHECK_SECONDARY_DUMP_DATA_EX
KBUGCHECK_TRIAGE_DUMP_DATA En savoir plus sur les alertes suivantes : structure _KBUGCHECK_TRIAGE_DUMP_DATA
KTRIAGE_DUMP_DATA_ARRAY En savoir plus sur les alertes suivantes : structure _KTRIAGE_DUMP_DATA_ARRAY
MCG_CAP En savoir plus sur les alertes suivantes : structure MCG_CAP
PCW_CALLBACK_INFORMATION L’union PCW_CALLBACK_INFORMATION fournit des détails sur la notification à envoyer. Un fournisseur transmet un pointeur vers cette union en tant que paramètre à la fonction PcwCallback.
PCW_COUNTER_DESCRIPTOR La structure PCW_COUNTER_DESCRIPTOR fournit des détails sur la notification à envoyer.
PCW_COUNTER_INFORMATION La structure PCW_COUNTER_INFORMATION décrit les attributs qui identifient une instance spécifique d’un compteur.
PCW_DATA La structure PCW_DATA décrit le tableau de blocs de données associés à une instance.
PCW_MASK_INFORMATION La structure PCW_MASK_INFORMATION fournit des détails sur la notification à envoyer au fournisseur. Ces informations sont transmises dans le cadre du paramètre Info à la fonction PcwCallback. Ces informations de masque sont incluses dans PCW_CALLBACK_INFORMATION.
PCW_REGISTRATION_INFORMATION La structure PCW_REGISTRATION_INFORMATION fournit des détails sur le fournisseur et le compteur.
RECORDER_CONFIGURE_PARAMS La structure RECORDER_CONFIGURE_PARAMS est un paramètre d’entrée de la méthode WppRecorderConfigure pour activer ou désactiver le journal par défaut sur lequel WPP imprime.
RECORDER_LOG_CREATE_PARAMS La structure RECORDER_LOG_CREATE_PARAMS est un paramètre d’entrée de la méthode WppRecorderLogCreate.
WPP_TRIAGE_INFO Utilisé pour localiser le journal WPP pour la création de rapports WER.

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-03-22