Compartilhar via


Escrevendo código de extensão WdbgExts

Os comandos de extensão WdbgExts podem chamar qualquer função C padrão, bem como as funções relacionadas ao depurador que aparecem no arquivo de cabeçalho WdbgExts.h.

As funções WdbgExts destinam-se apenas ao uso em comandos de extensão do depurador. Eles são úteis para controlar e inspecionar o computador ou aplicativo que está sendo depurado. O arquivo de cabeçalho WdbgExts.h deve ser incluído por qualquer código que esteja chamando essas funções WdbgExts.

Várias dessas funções têm versões de 32 bits, bem como versões de 64 bits. Normalmente, os nomes das funções WdbgExts de 64 bits terminam em "64", por exemplo , ReadIoSpace64. As versões de 32 bits não têm final numérico, por exemplo, ReadIoSpace. Se você estiver usando ponteiros de 64 bits, deverá usar o nome da função que termina em "64"; se você estiver usando ponteiros de 32 bits, deverá usar o nome da função "nãocortada". Ponteiros de 64 bits são recomendados para qualquer extensão que você esteja escrevendo. Consulte Ponteiros de 32 bits e Ponteiros de 64 bits para obter detalhes.

As extensões WdbgExts não podem usar as interfaces C++ que aparecem no arquivo de cabeçalho DbgEng.h. Se você quiser usar essas interfaces, deverá escrever uma extensão DbgEng ou uma extensão EngExtCpp. As extensões DbgEng e EngExtCpp podem usar todas as interfaces em DbgEng.h, bem como as do WdbgExts.h. Para obter detalhes, consulte Escrevendo extensões DbgEng e escrevendo extensões EngExtCpp.

Nota Você não deve tentar chamar nenhuma rotina DbgHelp ou ImageHlp de uma extensão de depurador. Isso não tem suporte e pode causar uma variedade de problemas.

Os tópicos a seguir fornecem uma visão geral de várias categorias de funções WdbgExts:

Entrada e saída WdbgExts

Acesso à memória WdbgExts

Threads e processos WdbgExts

Símbolos WdbgExts

Informações de destino do WdbgExts

Para obter uma lista completa dessas funções, consulte WdbgExts Functions.