Arquivos de metadados para plug-ins de extensão de análise
Ao escrever um plug-in de extensão de análise, você também escreve um arquivo de metadados que descreve as situações para as quais você deseja que seu plug-in seja chamado. Quando o comando !analyze depurgger é executado, ele usa arquivos de metadados para determinar quais plug-ins carregar.
Crie um arquivo de metadados que tenha o mesmo nome que seu plug-in de extensão de análise e uma extensão de .alz. Por exemplo, se o plug-in de extensão de análise for nomeado MyAnalyzer.dll, seu arquivo de metadados deverá ser chamado de MyAnalyzer.alz. Coloque o arquivo de metadados no mesmo diretório que o plug-in de extensão de análise.
Um arquivo de metadados para um plug-in de extensão de análise é um arquivo de texto ASCII que contém pares chave-valor. Chaves e valores são separados por espaço em branco. Uma chave pode ter qualquer caractere que não seja de espaço em branco. As chaves não diferenciam maiúsculas de minúsculas.
Após a chave e o espaço em branco a seguir, o valor correspondente começa. Um valor pode ter um dos formulários a seguir.
Qualquer conjunto de caracteres até o final da linha. Esse formulário funciona para valores que não contêm caracteres de nova linha.
Importante Se o último valor no arquivo de metadados tiver um valor desse formulário, a linha deverá terminar com um caractere de nova linha.
Qualquer conjunto de caracteres entre chaves { }. O formulário funciona para valores que contêm caracteres de nova linha.
Uma linha que começa com # é um comentário e é ignorada. Os comentários só podem começar onde as chaves são esperadas.
Você pode usar as seguintes chaves em um arquivo de metadados.
| Chave | Descrição |
|---|---|
| PluginId | Cadeia de caracteres – identifica o plug-in. |
| DebuggeeClass | Cadeia de caracteres – os valores possíveis são "Kernel" e "User". Indica que o plug-in está interessado em analisar apenas falhas no modo kernel ou apenas falhas no modo de usuário. |
| BugCheckCode | Código de marcar de bugs de 32 bits – indica que o plug-in está interessado em analisar esse bug marcar código. Um único arquivo de metadados pode especificar vários códigos de marcar de bugs. |
| ExceptionCode | Código de exceção de 32 bits – indica que o plug-in está interessado em analisar esse código de exceção. Um único arquivo de metadados pode especificar vários códigos de exceção. |
| ExecutableName | Cadeia de caracteres – indica que o plug-in está interessado apenas em sessões em que esse é o executável em execução do processo a ser analisado. Um único arquivo de metadados pode especificar vários nomes executáveis. |
| ImageName | Cadeia de caracteres – indica que o plug-in só está interessado em sessões em que a análise padrão considera essa imagem (dll, sys ou exe) como falha. O plug-in é invocado após a análise determinar qual imagem está em falha. Um único arquivo de metadados pode especificar vários nomes de imagem. |
| MaxTagCount | Inteiro – o número máximo de marcas personalizadas que o plug-in precisa. Marcas personalizadas são marcas diferentes daquelas definidas em extsfns.h. |
Arquivos de metadados de exemplo
O arquivo de metadados a seguir descreve um plug-in que está interessado em analisar marcar 0xE2 de código de bug. (Lembre-se de que a última linha deve terminar com um caractere de nova linha.)
PluginId MyPlugin
DebuggeeClass Kernel
BugCheckCode 0xE2
O arquivo de metadados a seguir descreve um plug-in que está interessado em analisar verificações de bugs 0x8, 0x9 e 0xA se MyDriver.sys for considerado o módulo com falha.
PluginId MyPlugin
DebuggeeClass Kernel
BugCheckCode 0x8
BugCheckCode 0x9
BugCheckCode 0xA
ImageName MyDriver.sys
O arquivo de metadados a seguir descreve um plug-in que está interessado em analisar o código de exceção 0xC0000005 se MyApp.exe for o executável em execução do processo que está sendo analisado. Além disso, o plug-in pode criar até três marcas personalizadas.
PluginId MyPlugin
DebuggeeClass User
ExceptionCode 0xC0000005
ExecutableName MyApp.exe
As Ferramentas de Depuração para Windows têm um exemplo que você pode usar para criar um módulo de extensão de depurador chamado dbgexts.dll. Este módulo de extensão implementa vários comandos de extensão de depurador, mas também pode servir como um plug-in de extensão de análise; ou seja, exporta uma função _EFN_Analyze . Aqui está um arquivo de metadados que descreve dbgexts.dll como um plug-in de extensão de análise.
PluginId PluginSample
DebuggeeClass User
ExceptionCode 0xc0000005
ExecutableName cdb.exe
ExecutableName windbg.exe
#
# Custom tag descriptions
#
TagDesc 0xA0000000 SAMPLE_PLUGIN_DEBUG_TEXT {Sample debug help text from plug-in analysis}
#
Confira também
Gravando um plug-in de extensão de análise para estender !analyze