Compartilhar via


Método IDebugFailureAnalysis::GetUlong64 (extsfns.h)

O método GetUlong64 pesquisa um objeto DebugFailureAnalysis para a primeira entrada fa que tem uma marca especificada. Se encontrar uma entrada FA com a marca especificada, ela obterá o valor ULONG64 do bloco de dados da entrada.

Sintaxe

PFA_ENTRY GetUlong64(
        FA_TAG   Tag,
  [out] PULONG64 Value
);

Parâmetros

Tag

Um valor na enumeração FA_TAG.

[out] Value

Um ponteiro para um ULONG64 que recebe o valor do bloco de dados da entrada.

Valor de retorno

Se esse método encontrar uma entrada fa com a marca especificada e se ele conseguir obter o bloco de dados, ele retornará um ponteiro para a estrutura FA_ENTRY. Caso contrário, ele retornará NULL.

Observações

Se esse método encontrar uma entrada fa com a marca especificada, ele verificará se o DataSize membro da estrutura FA_ENTRY é igual ao tamanho de um ULONG64. Se DataSize não for igual ao tamanho de um ULONG64, esse método retornará NULL e não obterá o bloco de dados.

Cada marca que já foi usada em um objeto de DebugFailureAnalysis está associada a um dos tipos de dados na enumeração FA_ENTRY_TYPE. Para determinar o tipo de dados associado a uma marca, chame o método GetType da interface IDebugFAEntryTags. Para obter um ponteiro para uma interface IDebugFAEntryTags, chame o método GetDebugFATagControl da interface IDebugFailureAnalysis2.

O uso apropriado desse método é obter o bloco de dados de uma entrada fa que tenha um tipo de dados de DEBUG_FA_ENTRY_ULONG64 ou DEBUG_FA_ENTRY_INSTRUCTION_OFFSET ou DEBUG_FA_ENTRY_POINTER.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho extsfns.h

Consulte também

AddUlong64

IDebugFailureAnalysis2

SetUlong64

escrever um plug-in de extensão de análise para estender !analisar

_EFN_Analyze