Partager via

Génération d’extensions WdbgExts

  • Article

Toutes les extensions de débogueur doivent être compilées et générées avec l’utilitaire Build. L’utilitaire Build est inclus dans le Kit de pilotes Windows (WDK) et dans les versions antérieures du DDK Windows.

Notez les points suivants :

  • Le WDK a plusieurs fenêtres d’environnement de build différentes. Un raccourci correspondant est placé dans le menu Démarrer lors de l’installation du WDK. Pour générer une extension de débogueur, vous devez utiliser l’environnement de build Windows le plus récent, quelle que soit la plateforme sur laquelle vous allez exécuter l’extension.

  • L’utilitaire Build n’est généralement pas en mesure de compiler le code qui se trouve dans un chemin d’accès de répertoire qui contient des espaces. Votre code d’extension doit se trouver dans un répertoire dont le chemin d’accès complet ne contient pas d’espaces. (En particulier, cela signifie que si vous installez Outils de débogage pour Windows à l’emplacement par défaut -- Program Files\Debugging Tools for Windows -- vous ne pourrez pas générer les exemples d’extensions.)

Pour générer une extension de débogueur

  1. Ouvrez la fenêtre pour l’environnement de build Windows le plus récent. (Vous pouvez choisir la version « gratuite » ou la version « vérifiée » ; elles donneront des résultats identiques, sauf si vous avez mis #ifdef instructions DBG dans votre code.)

  2. Définissez la variable _NT_TARGET_VERSION pour indiquer la version la plus ancienne de Windows sur laquelle vous souhaitez exécuter l’extension. _NT_TARGET_VERSION pouvez être défini sur les valeurs suivantes.

    Valeur Versions de Windows

    _NT_TARGET_VERSION_WIN2K

    Windows 2000 et versions ultérieures.

    _NT_TARGET_VERSION_WINXP

    Windows XP et versions ultérieures.

    _NT_TARGET_VERSION_WS03

    Windows Server 2003 et versions ultérieures.

    _NT_TARGET_VERSION_LONGHORN

    Windows Vista et versions ultérieures.

Si _NT_TARGET_VERSION n’est pas défini, l’extension s’exécute uniquement sur la version de Windows pour laquelle la fenêtre de build a été ouverte (et les versions ultérieures). Par exemple, l’ajout de la ligne suivante dans votre fichier Sources génère une extension qui s’exécutera sur Windows : console _NT_TARGET_VERSION = $(_NT_TARGET_VERSION_WINXP)

  1. Définissez les variables d’environnement DBGSDK_INC_PATH et DBGSDK_LIB_PATH pour spécifier les chemins d’accès aux en-têtes sdk du débogueur et aux bibliothèques du Kit de développement logiciel (SDK) du débogueur, respectivement. Si %debuggers% représente la racine de votre installation outils de débogage pour Windows, ces variables doivent être définies comme suit :

    set DBGSDK_INC_PATH=%debuggers%\sdk\inc
set DBGSDK_LIB_PATH=%debuggers%\sdk\lib

    Si vous avez déplacé ces en-têtes et bibliothèques vers un autre emplacement, spécifiez plutôt cet emplacement.

  2. Remplacez le répertoire actif par le répertoire qui contient le fichier Dirs ou le fichier Sources de votre extension.

  3. Exécutez l’utilitaire Build :

    build -cZMg

Pour obtenir une explication complète de ces étapes et une description de la création d’un fichier Dirs et d’un fichier Sources, consultez la documentation de l’utilitaire Build dans wdk.