Símbolos WdbgExts

Este tópico fornece uma breve visão geral de como os símbolos podem ser manipulados usando a API WdbgExts. Para obter uma visão geral do uso de símbolos no mecanismo de depurador, consulte Símbolos na seção Visão geral do Mecanismo de Depurador desta documentação.

Para avaliar uma expressão MASM ou C++, use as funções GetExpression ou GetExpressionEx.

Para ler o valor de um membro em uma estrutura, use a função GetFieldData ou, se o membro contiver um valor primitivo, GetFieldValue poderá ser usado. Para determinar o tamanho de uma instância de um símbolo na memória do destino, use a função GetTypeSize .

Para localizar o deslocamento de um membro em uma estrutura, use a função GetFieldOffset .

Para ler vários membros em uma estrutura, primeiro use a função InitTypeRead para inicializar a estrutura. Em seguida, você pode usar a função ReadField para ler os membros com tamanho menor ou igual a 8 bytes um de cada vez. Para endereços de estrutura na memória física, use a função InitTypeReadPhysical em vez de InitTypeRead.

Há duas funções que você pode usar para iterar em listas vinculadas. Para listas duplamente vinculadas que usam as estruturas LIST_ENTRY32 ou LIST_ENTRY64, a função ReadListEntry pode ser usada para localizar as entradas seguintes e anteriores. A função ListType iterará em todas as entradas em uma lista vinculada e chamará uma função de retorno de chamada para cada entrada.

Para localizar um símbolo próximo a um endereço especificado na memória do destino, use a função GetSymbol .

Para excluir todas as informações de símbolo do cache do mecanismo de depurador, use a função ReloadSymbols . Para ler ou alterar o caminho do símbolo, que é usado para pesquisar arquivos de símbolo, use a função GetSetSympath .

Quase todas as operações de símbolo fornecidas pelo mecanismo de depurador podem ser executadas usando a operação IoctlIG_DUMP_SYMBOL_INFO. No entanto, embora seja uma função muito flexível, ela é avançada e recomendamos que você use as funções mais simples acima, quando aplicável.

Informações adicionais

Para obter uma API de símbolos mais poderosa, consulte Usando símbolos na seção Usando a API do Mecanismo de Depurador desta documentação.