IDebugFailureAnalysis::GetUlong64 メソッド (extsfns.h)

GetUlong64 メソッドは、DebugFailureAnalysis オブジェクトで、指定したタグを持つ最初の FA エントリ を検索します。 指定したタグを持つ FA エントリが見つかると、エントリのデータ ブロックから ULONG64 値が取得されます。

構文

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

パラメーター

Tag

FA_TAG 列挙体の値。

[out] Value

エントリのデータ ブロックから値を受け取る 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_ULONG64 または DEBUG_FA_ENTRY_INSTRUCTION_OFFSET または DEBUG_FA_ENTRY_POINTERのデータ型を持つ FA エントリ からデータ ブロックを取得することです。

必要条件

関連項目

AddUlong64 を する

IDebugFailureAnalysis2

SetUlong64 を する

拡張する分析拡張機能プラグインの記述 !analyze

_EFN_Analyze