Outils de test de pilotes

Vue d’ensemble de la technologie Des outils de test de pilotes.

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

• 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 dans lequel WPP est imprimé.
WppRecorderDumpLiveDriverData, macro	La méthode WppRecorderDumpLiveDriverData obtient la mémoire tampon associée au journal de l’enregistreur de traces Inflight spécifié.
WppRecorderGetTriageInfo, macro	The WppRecorderGetTriageInfo.
Macro WppRecorderLinkCounters	The WppRecorderLinkCounters.
WppRecorderLogCreate, macro	La méthode WppRecorderLogCreate crée une mémoire tampon pour contenir le journal de l’enregistreur.
WppRecorderLogDelete, macro	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 vers cette énumération en tant que paramètre vers 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 s’insère dans le débogueur de noyau et lui envoie le message spécifié.
DbgBreakPoint La routine DbgBreakPoint s’insère dans le débogueur de noyau.
DbgBreakPointWithStatus La routine DbgBreakPointWithStatus s’interrompt dans le débogueur de 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 de 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 qui est 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 mot clé spécifiés.
EtwRegister La fonction EtwRegister inscrit le fournisseur d’événements et doit être appelée avant qu’un fournisseur puisse commencer 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 s’insère dans le débogueur de noyau et envoie la valeur Status au débogueur.
KdChangeOption La routine KdChangeOption accède et change l’état dans le noyau lié au débogage du noyau.
KdDisableDebugger La routine KdDisableDebugger désactive le débogueur de noyau.
KdEnableDebugger La routine KdEnableDebugger réactive le débogueur de noyau après qu’un appel à la routine KdDisableDebugger désactive le débogueur de noyau.
KdPrint La macro KdPrint envoie un message au débogueur du noyau.
KdPrintEx La macro KdPrintEx envoie une chaîne au débogueur de noyau si les conditions que vous spécifiez sont remplies. Un appel à KdPrintEx nécessite une double parenthèse.
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 de triage.
PCW_CALLBACK Les fournisseurs peuvent implémenter une fonction PCW_CALLBACK pour recevoir une notification lorsque les consommateurs effectuent certaines actions, telles que l’ajout ou la suppression de compteurs d’une requête.
PcwAddInstance La fonction PcwAddInstance ajoute le instance spécifié du compteur à la mémoire tampon du consommateur.
PcwCloseInstance La fonction PcwCloseInstance ferme le instance spécifié du compteur.
PcwCreateInstance La fonction PcwCreateInstance crée un 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 vers les journaux de liaison.
SeEtwWriteKMCveEvent La fonction SeEtwWriteKMCveEvent est une fonction de suivi pour la publication d’événements lorsqu’une tentative d’exploitation de vulnérabilité de sécurité est détectée dans vos pilotes en mode noyau.
vDbgPrintEx La routine vDbgPrintEx envoie une chaîne au débogueur de 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 dans lequel WPP s’imprime.
WppRecorderDumpLiveDriverData Découvrez comment la méthode WppRecorderDumpLiveDriverData obtient la mémoire tampon associée au journal de l’enregistreur de traces 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 : structure DEBUG_DEVICE_DESCRIPTOR
DEBUG_TRANSPORT_DATA Décrit les données spécifiques de débogage-transport à 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 : structure KBUGCHECK_CALLBACK_RECORD
KBUGCHECK_REASON_CALLBACK_RECORD En savoir plus sur : structure KBUGCHECK_REASON_CALLBACK_RECORD
KBUGCHECK_REMOVE_PAGES En savoir plus sur : structure KBUGCHECK_REMOVE_PAGES
KBUGCHECK_SECONDARY_DUMP_DATA_EX En savoir plus sur : structure _KBUGCHECK_SECONDARY_DUMP_DATA_EX
KBUGCHECK_TRIAGE_DUMP_DATA En savoir plus sur : structure _KBUGCHECK_TRIAGE_DUMP_DATA
KTRIAGE_DUMP_DATA_ARRAY En savoir plus sur : structure _KTRIAGE_DUMP_DATA_ARRAY
MCG_CAP En savoir plus sur : 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 vers 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 un instance spécifique d’un compteur.
PCW_DATA La structure PCW_DATA décrit le tableau de blocs de données associés à un 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 dans lequel WPP s’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.