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

[アーティクル]
03/05/2024

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

構文

PFA_ENTRY GetBuffer(
  [in]  FA_TAG Tag,
  [out] PVOID  Buf,
  [in]  ULONG  Size
);

パラメーター

[in] Tag

FA_TAG列挙の値。

[out] Buf

エントリのデータブロックを受け取るバッファーへのポインター。

[in] Size

Buf が指すバッファーのサイズ (バイト単位)。

戻り値

このメソッドは、指定されたタグを持つ FA エントリを検索し、データブロックの取得に成功した場合は、 FA_ENTRY 構造体へのポインターを返します。それ以外の場合は NULL を返します。

注釈

このメソッドは、指定したタグを持つ FA エントリを検索する場合は、FA_ENTRY構造体の DataSize メンバーが Size パラメーターで指定された値と等しいかどうかを確認します。 DataSize が Size と等しくない場合、このメソッドは NULL を返し、データブロックを取得しません。