en-tête wdbgexts.h

Article
08/08/2023

Cet en-tête est utilisé par le débogueur. Pour plus d'informations, consultez les pages suivantes :

Débogueur

wdbgexts.h contient les interfaces de programmation suivantes :

Fonctions


GetCurrentProcessAddr La fonction GetCurrentProcessAddr retourne l’emplacement des données système qui décrivent le processus actuel.
GetCurrentProcessHandle La fonction GetCurrentProcessHandle retourne le handle système pour le processus en cours.
GetCurrentThreadAddr La fonction GetCurrentThreadAddr retourne l’emplacement des données système qui décrivent le thread actuel.
GetDebuggerCacheSize La fonction GetDebuggerCacheSize retourne la taille du cache utilisé par le débogueur pour contenir les données obtenues à partir de la cible.
GetDebuggerData La fonction GetDebuggerData récupère les informations stockées dans un bloc de données.
GetExpressionEx La fonction GetExpressionEx évalue une expression. L’expression est évaluée à l’aide de l’évaluateur MASM et peut contenir des alias.
GetFieldData La fonction GetFieldData retourne la valeur d’un membre dans une structure.
GetFieldOffset La fonction GetFieldOffset retourne le décalage d’un membre à partir du début d’une structure.
GetFieldValue La macro GetFieldValue est un wrapper mince autour de la fonction GetFieldData. Il est fourni pour faciliter la lecture de la valeur d’un membre dans une structure.
GetInputLine La fonction GetInputLine demande une chaîne d’entrée au débogueur.
GetKdContext La fonction GetKdContext retourne le nombre total de processeurs et le nombre de processeurs actuels dans la structure vers laquelle pointe le ppp.
GetPebAddress La fonction GetPebAddress retourne l’adresse du bloc d’environnement de processus (PEB) d’un processus système.
GetSetSympath La fonction GetSetSympath peut être utilisée pour obtenir ou définir le chemin de recherche de symboles.
GetShortField La fonction GetShortField lit la valeur d’un membre dans une structure si sa taille est inférieure ou égale à 8 octets, ou initialise une structure afin qu’elle puisse être lue ultérieurement.
GetTebAddress La fonction GetTebAddress retourne l’adresse du bloc d’environnement de thread (TEB) pour le thread du système d’exploitation actuel.
GetTypeSize La fonction GetTypeSize retourne la taille dans la mémoire de la cible d’un instance du type spécifié.
IsPtr64 La fonction IsPtr64 détermine si la cible utilise des pointeurs 64 bits.
ListType La fonction ListType appelle une fonction de rappel spécifiée pour chaque élément d’une liste liée.
ReadControlSpace La fonction ReadControlSpace lit l’espace de contrôle spécifique au processeur dans le tableau pointé par buf.
ReadControlSpace64 La fonction ReadControlSpace64 lit l’espace de contrôle spécifique au processeur dans le tableau pointé par buf.
ReadIoSpace La fonction ReadIoSpace lit à partir des emplacements d’E/S système.
ReadIoSpace64 La fonction ReadIoSpace64 lit à partir des emplacements d’E/S système.
ReadIoSpaceEx La fonction ReadIoSpaceEx est une version étendue de ReadIoSpace.
ReadIoSpaceEx64 La fonction ReadIoSpaceEx64 est une version étendue de ReadIoSpace64.
ReadListEntry La fonction ReadListEntry lit une entrée de liste doublement liée à partir de la mémoire de la cible.
ReadMsr La fonction ReadMsr lit le contenu d’un Model-Specific Register (MSR).
ReadPhysical La fonction ReadPhysical lit à partir de la mémoire physique.
ReadPhysicalWithFlags La fonction ReadPhysicalWithFlags lit à partir de la mémoire physique.
ReadPointer La fonction ReadPointer lit un pointeur à partir de la cible.
ReadPtr La fonction ReadPtr lit un pointeur à partir de la cible. ReadPointer doit être utilisé à la place de cette fonction, car la valeur de retour de ReadPointer est plus cohérente avec le reste de l’API WdbgExts.
RechargementSymbols La fonction ReloadSymbols supprime les informations de symbole du débogueur afin qu’elles puissent être rechargées en fonction des besoins. Cette fonction se comporte de la même façon que la commande de débogueur .reload.
SearchMemory La fonction SearchMemory recherche un modèle d’octets spécifié dans la mémoire virtuelle de la cible.
SetThreadForOperation La fonction SetThreadForOperation définit le thread à utiliser pour l’appel StackTrace suivant.
SetThreadForOperation64 La fonction SetThreadForOperation64 définit le thread à utiliser pour l’appel StackTrace suivant.
TranslateVirtualToPhysical La fonction TranslateVirtualToPhysical traduit une adresse de mémoire virtuelle en adresse de mémoire physique.
WriteControlSpace La fonction WriteControlSpace écrit dans l’espace de contrôle spécifique au processeur de la cible actuelle.
WriteIoSpace La fonction WriteIoSpace écrit dans les emplacements d’E/S système.
WriteIoSpace64 La fonction WriteIoSpace64 écrit dans les emplacements d’E/S système.
WriteIoSpaceEx La fonction WriteIoSpaceEx est une version étendue de WriteIoSpace.
WriteIoSpaceEx64 La fonction WriteIoSpaceEx64 est une version étendue de WriteIoSpace64.
WriteMsr La fonction WriteMsr écrit dans un Model-Specific Register (MSR).
WritePhysical La fonction WritePhysical écrit dans la mémoire physique.
WritePhysicalWithFlags La fonction WritePhysicalWithFlags écrit dans la mémoire physique.
WritePointer La fonction WritePointer écrit un pointeur vers la cible.

Fonctions de rappel


PSYM_DUMP_FIELD_CALLBACK La fonction de rappel PSYM_DUMP_FIELD_CALLBACK est appelée par le moteur de débogueur pendant l’opération ioctl IG_DUMP_SYMBOL_INFO avec des informations sur un membre dans le symbole spécifié.
PWINDBG_CHECK_CONTROL_C La fonction PWINDBG_CHECK_CONTROL_C (CheckControlC) vérifie si l’utilisateur a appuyé sur Ctrl+C. Utilisez PWINDBG_CHECK_CONTROL_C dans toutes les boucles pour permettre à l’utilisateur d’appuyer sur Ctrl+C pour mettre fin aux processus longs.
PWINDBG_CHECK_VERSION La fonction de rappel PWINDBG_CHECK_VERSION (CheckVersion) vérifie que la version du module d’extension correspond à la version du débogueur et génère un message d’avertissement en cas d’incompatibilité.
PWINDBG_DISASM La fonction PWINDBG_DISASM (Disasm) désassemble l’instruction pointée par lpOffset et place la chaîne imprimable dans lpBuffer.
PWINDBG_EXTENSION_API_VERSION La fonction de rappel PWINDBG_EXTENSION_API_VERSION (ExtensionApiVersion) retourne des informations de version sur la DLL d’extension.
PWINDBG_EXTENSION_DLL_INIT La fonction de rappel PWINDBG_EXTENSION_DLL_INIT ( WinDbgExtensionDllInit) est utilisée pour charger et initialiser le module d’extension.
PWINDBG_GET_EXPRESSION La fonction PWINDBG_GET_EXPRESSION (GetExpression) retourne la valeur de l’expression. L’expression est évaluée à l’aide de l’évaluateur d’expression actuel et peut contenir des alias.
PWINDBG_GET_SYMBOL La fonction PWINDBG_GET_SYMBOL (GetSymbol) localise le symbole le plus proche de l’adresse.
PWINDBG_GET_THREAD_CONTEXT_ROUTINE La fonction PWINDBG_GET_THREAD_CONTEXT_ROUTINE (GetContext) implémente la fonctionnalité similaire à la routine Microsoft Win32 GetThreadContext. Elle retourne le contexte du processus en cours de débogage.
PWINDBG_IOCTL_ROUTINE La fonction PWINDBG_IOCTL_ROUTINE (Ioctl) effectue différentes opérations. La plupart de ses fonctionnalités reflètent les fonctionnalités d’autres fonctions dans wdbgexts.h.
PWINDBG_OUTPUT_ROUTINE La fonction de rappel implémente la fonctionnalité pour imprimer une chaîne mise en forme dans la fenêtre Commande du débogueur.
PWINDBG_READ_PROCESS_MEMORY_ROUTINE La fonction PWINDBG_READ_PROCESS_MEMORY_ROUTINE (ReadMemory) fonctionne comme la fonction Win32 ReadProcessMemory. Il lit la mémoire du processus en cours de débogage. La zone entière à lire doit être accessible, sinon l’opération échoue.
PWINDBG_SET_THREAD_CONTEXT_ROUTINE La fonction PWINDBG_SET_THREAD_CONTEXT_ROUTINE (SetContext) est similaire à la routine Win32 SetThreadContext. Il définit le contexte du processus en cours de débogage.
PWINDBG_STACKTRACE_ROUTINE La fonction PWINDBG_STACKTRACE_ROUTINE (StackTrace) récupère une trace de pile pour le processus en cours de débogage. Retourne le nombre de trames lues dans la mémoire tampon pointée par StackFrames.
PWINDBG_WRITE_PROCESS_MEMORY_ROUTINE La fonction PWINDBG_WRITE_PROCESS_MEMORY_ROUTINE (WriteMemory) fonctionne comme la routine Win32 WriteProcessMemory. Il écrit de la mémoire dans le processus en cours de débogage. La zone entière à écrire doit être accessible, sinon l’opération échoue.

Structures


BUSDATA L’opération Ioctl IG_GET_BUS_DATA lit les données d’un bus système et l’opération Ioctl IG_SET_BUS_DATA écrit les données dans un bus système.
DBGKD_GET_VERSION64 L’opération ioctl IG_GET_KERNEL_VERSION reçoit des informations relatives à la version du système d’exploitation de la cible.
DEBUG_TYPED_DATA La structure DEBUG_TYPED_DATA décrit les données typées dans la mémoire de la cible.
EXT_TYPED_DATA La structure EXT_TYPED_DATA est passée à et retournée à partir de l’opération DEBUG_REQUEST_EXT_TYPED_DATA_ANSI Request. Il contient les paramètres d’entrée et de sortie de l’opération, ainsi que la spécification de la sous-opération particulière à effectuer.
FIELD_INFO La structure FIELD_INFO est utilisée par l’opération IG_DUMP_SYMBOL_INFOIoctl pour fournir des informations sur un membre dans une structure.
POINTER_SEARCH_PHYSICAL L’opération Ioctl IG_POINTER_SEARCH_PHYSICAL recherche dans la mémoire physique de la cible des pointeurs situés dans une plage spécifiée.
READCONTROLSPACE Découvrez comment la fonction ReadControlSpace lit l’espace de contrôle spécifique au processeur dans le tableau pointé par buf.
READCONTROLSPACE64 Découvrez comment la fonction ReadControlSpace64 lit l’espace de contrôle spécifique au processeur dans le tableau pointé par buf.
SEARCHMEMORY Découvrez comment la fonction SearchMemory recherche un modèle d’octets spécifié dans la mémoire virtuelle de la cible.
SYM_DUMP_PARAM L’opération Ioctl IG_DUMP_SYMBOL_INFO fournit des informations sur le type d’un symbole.
WDBGEXTS_THREAD_OS_INFO L’opération Ioctl IG_GET_THREAD_OS_INFO retourne des informations sur un thread de système d’exploitation dans la cible. Lorsque vous appelez Ioctl avec IoctlType défini sur IG_GET_THREAD_OS_INFO, IpvData doit contenir un instance de la structure WDBGEXTS_THREAD_OS_INFO.

Énumérations


EXT_TDOP L’énumération EXT_TDOP est utilisée dans le membre Operation de la structure EXT_TYPED_DATA pour spécifier la sous-opération que l’opération de requête DEBUG_REQUEST_EXT_TYPED_DATA_ANSI effectuera.

Partager via

en-tête wdbgexts.h

Fonctions

Fonctions de rappel

Structures

Énumérations

Commentaires

Ressources supplémentaires