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

[アーティクル]
02/26/2024

GetUlong64 メソッドは、指定されたタグを持つ最初の FA エントリについて DebugFailureAnalysis オブジェクトを検索します。指定したタグを持つ 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 エントリからデータブロックを取得します。