Freigeben über

Erstellen von WdbgExts-Erweiterungen

  • Artikel

Alle Debuggererweiterungen sollten mit dem Build-Hilfsprogramm kompiliert und erstellt werden. Das Build-Hilfsprogramm ist im Windows Driver Kit (WDK) und in früheren Versionen des Windows DDK enthalten.

Beachten Sie folgende Punkte:

  • Das WDK verfügt über mehrere unterschiedliche Buildumgebungsfenster. Jede dieser Elemente verfügt über eine entsprechende Verknüpfung im Startmenü , wenn das WDK installiert ist. Zum Erstellen einer Debuggererweiterung müssen Sie die neueste Windows-Buildumgebung verwenden, unabhängig davon, auf welcher Plattform Sie die Erweiterung ausführen.

  • Das Build-Hilfsprogramm kann normalerweise keinen Code kompilieren, der sich in einem Verzeichnispfad befindet, der Leerzeichen enthält. Der Erweiterungscode sollte sich in einem Verzeichnis befinden, dessen vollständiger Pfad keine Leerzeichen enthält. (Dies bedeutet insbesondere, dass Sie die Beispielerweiterungen nicht erstellen können, wenn Sie Debugtools für Windows am Standardspeicherort –- Programme\Debugtools für Windows - installieren.)

So erstellen Sie eine Debuggererweiterung

  1. Öffnen Sie das Fenster für die neueste Windows-Buildumgebung. (Sie können entweder die "kostenlose" Version oder die "überprüfte" Version auswählen . Sie erhalten identische Ergebnisse, es sei denn, Sie haben #ifdef DBG-Anweisungen in Ihren Code eingefügt.)

  2. Legen Sie die Variable _NT_TARGET_VERSION fest, um die älteste Version von Windows anzugeben, unter der Sie die Erweiterung ausführen möchten. _NT_TARGET_VERSION können auf die folgenden Werte festgelegt werden.

    Wert Versionen von Windows

    _NT_TARGET_VERSION_WIN2K

    Windows 2000 und höher.

    _NT_TARGET_VERSION_WINXP

    Windows XP und höher.

    _NT_TARGET_VERSION_WS03

    Windows Server 2003 und höher.

    _NT_TARGET_VERSION_LONGHORN

    Windows Vista und höher.

Wenn _NT_TARGET_VERSION nicht festgelegt ist, wird die Erweiterung nur für die Windows-Version ausgeführt, für die das Buildfenster geöffnet wurde (und höhere Versionen). Wenn Sie beispielsweise die folgende Zeile in Ihrer Sources-Datei einfügen, wird eine Erweiterung erstellt, die unter Windows ausgeführt wird: console _NT_TARGET_VERSION = $(_NT_TARGET_VERSION_WINXP)

  1. Legen Sie die umgebungsvariablen DBGSDK_INC_PATH und DBGSDK_LIB_PATH fest, um die Pfade zu den Debugger-SDK-Headern bzw. den Debugger-SDK-Bibliotheken anzugeben. Wenn %debuggers% den Stamm ihrer Debugtools für Windows-Installation darstellt, sollten diese Variablen wie folgt festgelegt werden:

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

    Wenn Sie diese Header und Bibliotheken an einen anderen Speicherort verschoben haben, geben Sie stattdessen diesen Speicherort an.

  2. Ändern Sie das aktuelle Verzeichnis in das Verzeichnis, das die Dirs- oder Sources-Datei Ihrer Erweiterung enthält.

  3. Führen Sie das Build-Hilfsprogramm aus:

    build -cZMg

Eine vollständige Erläuterung dieser Schritte sowie eine Beschreibung zum Erstellen einer Dirs-Datei und einer Sources-Datei finden Sie in der Dokumentation zum Erstellen des Hilfsprogramms im WDK.