Поделиться через

Создание расширений WdbgExts

  • Статья

Все расширения отладчика должны компилироваться и создаваться с помощью служебной программы сборки. Служебная программа Сборка входит в комплект драйверов Windows (WDK) и в более ранних версиях Windows DDK.

Обратите внимание на следующие моменты.

  • WDK имеет несколько различных окон среды сборки. Каждый из них имеет соответствующий ярлык, размещенный в меню "Пуск" при установке WDK. Чтобы создать расширение отладчика, необходимо использовать последнюю версию среды сборки Windows независимо от платформы, на которой будет выполняться расширение.

  • Служебная программа сборки обычно не может компилировать код, расположенный в пути к каталогу, содержащем пробелы. Код расширения должен находиться в каталоге, полный путь которого не содержит пробелов. (В частности, это означает, что при установке средств отладки для Windows в расположении по умолчанию — Program Files\Debugging Tools for Windows — вы не сможете создать примеры расширений.)

Создание расширения отладчика

  1. Откройте окно для последней версии среды сборки Windows. (Вы можете выбрать "бесплатную" версию или "установленную" версию. Они будут давать одинаковые результаты, если вы не добавили #ifdef инструкции DBG в коде.)

  2. Задайте переменную _NT_TARGET_VERSION, чтобы указать старую версию Windows, в которой требуется запустить расширение. _NT_TARGET_VERSION можно задать следующие значения.

    Значение Версии Windows

    _NT_TARGET_VERSION_WIN2K

    Windows 2000 и более поздние версии.

    _NT_TARGET_VERSION_WINXP

    Windows XP и более поздних версий.

    _NT_TARGET_VERSION_WS03

    Windows Server 2003 и более поздние версии.

    _NT_TARGET_VERSION_LONGHORN

    Windows Vista и более поздних версий.

Если _NT_TARGET_VERSION не задано, расширение будет выполняться только в той версии Windows, для которой было открыто окно сборки (и более поздних версий). Например, если поместить следующую строку в файл Sources, будет создано расширение, которое будет выполняться в Windows: console _NT_TARGET_VERSION = $(_NT_TARGET_VERSION_WINXP)

  1. Задайте переменные среды DBGSDK_INC_PATH и DBGSDK_LIB_PATH, чтобы указать пути к заголовкам пакета SDK отладчика и библиотекам пакета SDK для отладчика соответственно. Если %debuggers% представляет корень установки средств отладки для Windows, эти переменные следует задать следующим образом:

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

    Если вы переместили эти заголовки и библиотеки в другое расположение, укажите это расположение.

  2. Измените текущий каталог на каталог, содержащий файл Dirs расширения или файл Sources.

  3. Запустите служебную программу сборки:

    build -cZMg

Полное описание этих действий, а также описание создания файлов Dirs и Sources см. в документации по служебной программе сборки в WDK.