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

El método GetUlong64 busca un objeto DebugFailureAnalysis para la primera entrada fa que tiene una etiqueta especificada. Si encuentra una entrada fa con la etiqueta especificada, obtiene el valor ULONG64 del bloque de datos de la entrada.

Sintaxis

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

Parámetros

Tag

Valor de la enumeración FA_TAG .

[out] Value

Puntero a un ULONG64 que recibe el valor del bloque de datos de la entrada.

Valor devuelto

Si este método encuentra una entrada fa con la etiqueta especificada y, si se realiza correctamente al obtener el bloque de datos, devuelve un puntero a la estructura FA_ENTRY . De lo contrario, devuelve NULL.

Comentarios

Si este método encuentra una entrada fa con la etiqueta especificada, comprueba si el miembro DataSize de la estructura de FA_ENTRY es igual al tamaño de un ULONG64. Si DataSize no es igual al tamaño de un ULONG64, este método devuelve NULL y no obtiene el bloque de datos.

Cada etiqueta que ya se ha usado en un objeto DebugFailureAnalysis está asociada a uno de los tipos de datos de la enumeración FA_ENTRY_TYPE . Para determinar el tipo de datos asociado a una etiqueta, llame al método GetType de la interfaz IDebugFAEntryTags . Para obtener un puntero a una interfaz IDebugFAEntryTags, llame al método GetDebugFATagControl de la interfaz IDebugFailureAnalysis2 .

El uso adecuado de este método es obtener el bloque de datos de una entrada fa que tiene un tipo de datos de DEBUG_FA_ENTRY_ULONG64 o DEBUG_FA_ENTRY_INSTRUCTION_OFFSET o DEBUG_FA_ENTRY_POINTER.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado extsfns.h

Consulte también

AddUlong64

IDebugFailureAnalysis2

SetUlong64

Escribir un complemento de extensión de análisis para ampliar !analyze

_EFN_Analyze