IDebugFailureAnalysis::GetUlong64 方法 (extsfns.h)

GetUlong64 方法在 DebugFailureAnalysis 对象中搜索具有指定标记的第一个 FA 条目。 如果找到具有指定标记的 FA 条目,它将从条目的数据块中获取 ULONG64 值。

语法

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

参数

Tag

FA_TAG枚举中的值。

[out] Value

指向 ULONG64 的指针,该 ULONG64 从条目的数据块接收值。

返回值

如果此方法找到具有指定标记的 FA 条目 ,如果成功获取数据块,则返回指向 FA_ENTRY 结构的指针。 否则,它将返回 NULL

注解

如果此方法找到具有指定标记的 FA 条目,它将检查FA_ENTRY结构的 DataSize 成员是否等于 ULONG64 的大小。 如果 DataSize 不等于 ULONG64 的大小,此方法将返回 NULL ,并且不获取数据块。

DebugFailureAnalysis 对象中使用的每个标记都与FA_ENTRY_TYPE枚举中的其中一种数据类型相关联。 若要确定与标记关联的数据类型,请调用 IDebugFAEntryTags 接口的 GetType 方法。 若要获取指向 IDebugFAEntryTags 接口的指针,请调用 IDebugFailureAnalysis2 接口的 GetDebugFATagControl 方法。

此方法的适当用法是从具有数据类型为 DEBUG_FA_ENTRY_ULONG64DEBUG_FA_ENTRY_INSTRUCTION_OFFSETDEBUG_FA_ENTRY_POINTERFA 条目获取数据块。

要求

   
目标平台 桌面
Header extsfns.h

另请参阅

AddUlong64

IDebugFailureAnalysis2

SetUlong64

编写分析扩展插件以扩展 !analyze

_EFN_Analyze