Partager via


Écriture du code d’extension WdbgExts

Les commandes d’extension WdbgExts peuvent appeler n’importe quelle fonction C standard, ainsi que les fonctions liées au débogueur qui apparaissent dans le fichier d’en-tête WdbgExts.h.

Les fonctions WdbgExts sont destinées à être utilisées uniquement dans les commandes d’extension du débogueur. Ils sont utiles pour contrôler et inspecter l’ordinateur ou l’application en cours de débogage. Le fichier d’en-tête WdbgExts.h doit être inclus par tout code qui appelle ces fonctions WdbgExts.

Un certain nombre de ces fonctions ont des versions 32 bits ainsi que des versions 64 bits. En règle générale, les noms des fonctions WdbgExts 64 bits se terminent par « 64 », par exemple ReadIoSpace64. Les versions 32 bits n’ont pas de fin numérique, par exemple ReadIoSpace. Si vous utilisez des pointeurs 64 bits, vous devez utiliser le nom de la fonction se terminant par « 64 » ; Si vous utilisez des pointeurs 32 bits, vous devez utiliser le nom de la fonction « non décorée ». Les pointeurs 64 bits sont recommandés pour toute extension que vous écrivez. Pour plus d’informations, consultez Pointeurs 32 bits et Pointeurs 64 bits .

Les extensions WdbgExts ne peuvent pas utiliser les interfaces C++ qui apparaissent dans le fichier d’en-tête DbgEng.h. Si vous souhaitez utiliser ces interfaces, vous devez écrire une extension DbgEng ou une extension EngExtCpp à la place. Les extensions DbgEng et EngExtCpp peuvent utiliser toutes les interfaces dans DbgEng.h, ainsi que celles de WdbgExts.h. Pour plus d’informations, consultez Écriture d’extensions DbgEng et Écriture d’extensions EngExtCpp.

Note Vous ne devez pas essayer d’appeler des routines DbgHelp ou ImageHlp à partir d’une extension de débogueur. Cela n’est pas pris en charge et peut entraîner divers problèmes.

Les rubriques suivantes donnent une vue d’ensemble des différentes catégories de fonctions WdbgExts :

Entrée et sortie WdbgExts

Accès à la mémoire WdbgExts

Threads et processus WdbgExts

Symboles WdbgExts

Informations sur la cible WdbgExts

Pour obtenir la liste complète de ces fonctions, consultez Fonctions WdbgExts.