Compartilhar via

Criando extensões WdbgExts

  • Artigo

Todas as extensões do depurador devem ser compiladas e criadas com o utilitário Build. O utilitário Build está incluído no WDK (Windows Driver Kit) e em versões anteriores do DDK do Windows.

Observe os seguintes pontos:

  • O WDK tem várias janelas de ambiente de build diferentes. Cada um deles tem um atalho correspondente colocado no menu Iniciar quando o WDK é instalado. Para criar uma extensão de depurador, você deve usar o ambiente de build mais recente do Windows, independentemente de qual plataforma você executará a extensão.

  • O utilitário Build geralmente não é capaz de compilar o código localizado em um caminho de diretório que contém espaços. Seu código de extensão deve estar localizado em um diretório cujo caminho completo não contém espaços. (Em particular, isso significa que, se você instalar as Ferramentas de Depuração para Windows no local padrão – Arquivos de Programas\Ferramentas de Depuração para Windows – você não poderá criar as extensões de exemplo.)

Para criar uma extensão de depurador

  1. Abra a janela para o ambiente de build mais recente do Windows. (Você pode escolher a versão "gratuita" ou a versão "marcada" – eles fornecerão resultados idênticos, a menos que você tenha colocado #ifdef instruções DBG em seu código.)

  2. Defina a variável _NT_TARGET_VERSION para indicar a versão mais antiga do Windows na qual você deseja executar a extensão. _NT_TARGET_VERSION pode ser definido com os valores a seguir.

    Valor Versões do Windows

    _NT_TARGET_VERSION_WIN2K

    Windows 2000 e posterior.

    _NT_TARGET_VERSION_WINXP

    Windows XP e posterior.

    _NT_TARGET_VERSION_WS03

    Windows Server 2003 e posterior.

    _NT_TARGET_VERSION_LONGHORN

    Windows Vista e posteriores.

Se _NT_TARGET_VERSION não estiver definida, a extensão só será executada na versão do Windows para a qual a janela de build foi aberta (e versões posteriores). Por exemplo, colocar a seguinte linha no arquivo Fontes criará uma extensão que será executada no Windows: console _NT_TARGET_VERSION = $(_NT_TARGET_VERSION_WINXP)

  1. Defina as variáveis de ambiente DBGSDK_INC_PATH e DBGSDK_LIB_PATH para especificar os caminhos para os cabeçalhos do SDK do depurador e as bibliotecas do SDK do depurador, respectivamente. Se %depuradores% representarem a raiz das ferramentas de depuração para instalação do Windows, essas variáveis deverão ser definidas da seguinte maneira:

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

    Se você tiver movido esses cabeçalhos e bibliotecas para um local diferente, especifique esse local.

  2. Altere o diretório atual para o diretório que contém o arquivo Dirs da extensão ou o arquivo Sources.

  3. Execute o utilitário Build:

    build -cZMg

Para obter uma explicação completa dessas etapas e para obter uma descrição de como criar um arquivo Dirs e um arquivo Sources, consulte a documentação do utilitário Build no WDK.