Symboles WdbgExts

Cette rubrique fournit une brève vue d’ensemble de la façon dont les symboles peuvent être manipulés à l’aide de l’API WdbgExts. Pour une vue d’ensemble de l’utilisation des symboles dans le moteur de débogueur, consultez Symboles dans la section Vue d’ensemble du moteur de débogueur de cette documentation.

Pour évaluer une expression MASM ou C++, utilisez les fonctions GetExpression ou GetExpressionEx.

Pour lire la valeur d’un membre dans une structure, utilisez la fonction GetFieldData ou, si le membre contient une valeur primitive, GetFieldValue peut être utilisé. Pour déterminer la taille d’un instance d’un symbole dans la mémoire de la cible, utilisez la fonction GetTypeSize.

Pour localiser le décalage d’un membre dans une structure, utilisez la fonction GetFieldOffset .

Pour lire plusieurs membres dans une structure, utilisez d’abord la fonction InitTypeRead pour initialiser la structure. Ensuite, vous pouvez utiliser la fonction ReadField pour lire les membres dont la taille est inférieure ou égale à 8 octets, un par un. Pour les adresses de structure dans la mémoire physique, utilisez la fonction InitTypeReadPhysical au lieu de InitTypeRead.

Il existe deux fonctions que vous pouvez utiliser pour itérer sur des listes liées. Pour les listes doublement liées qui utilisent les structures LIST_ENTRY32 ou LIST_ENTRY64, la fonction ReadListEntry peut être utilisée pour rechercher les entrées suivantes et précédentes. La fonction ListType itérera sur toutes les entrées d’une liste liée et appellera une fonction de rappel pour chaque entrée.

Pour localiser un symbole près d’une adresse spécifiée dans la mémoire de la cible, utilisez la fonction GetSymbol .

Pour supprimer toutes les informations de symbole du cache du moteur de débogueur, utilisez la fonction ReloadSymbols . Pour lire ou modifier le chemin des symboles, qui est utilisé pour rechercher des fichiers de symboles, utilisez la fonction GetSetSympath .

Presque toutes les opérations de symboles fournies par le moteur de débogueur peuvent être exécutées à l’aide de l’opération IoctlIG_DUMP_SYMBOL_INFO. Toutefois, bien qu’il s’agit d’une fonction très flexible, elle est avancée et nous vous recommandons d’utiliser les fonctions plus simples ci-dessus, le cas échéant.

Informations supplémentaires

Pour obtenir une API de symboles plus puissante, consultez Utilisation de symboles dans la section Utilisation de l’API du moteur de débogueur de cette documentation.