IDebugFailureAnalysis2::SetBuffer メソッド (extsfns.h)

[アーティクル]
08/07/2023

SetBuffer メソッドは、指定されたタグを持つ最初の FA エントリを DebugFailureAnalysis オブジェクトで検索します。指定したタグを持つ FA エントリが見つかると、FA エントリのデータブロックが、指定したバッファー内のバイトで上書きされます。このメソッドは、指定したタグを持つ FA エントリが見つからない場合は、そのタグを使用して新しい FA エントリを作成し、指定されたバッファー内のデータで新しい FA エントリのデータブロックを上書きします。

構文

PFA_ENTRY SetBuffer(
       FA_TAG        Tag,
  [in] FA_ENTRY_TYPE EntryType,
  [in] PVOID         Buf,
  [in] ULONG         Size
);

パラメーター

Tag

FA_TAG列挙の値。

[in] EntryType

FA_ENTRY_TYPE列挙の値。このパラメーターは、 Buf 内のデータのデータ型を指定します。

[in] Buf

新規または既存の FA 項目のデータ・ブロックに書き込まれるバイトを含むバッファーへのポインター。

[in] Size

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

戻り値

このメソッドが成功すると、新規または既存の FA_ENTRY 構造体へのポインターが返されます。それ以外の場合は NULL を返します。

注釈

このメソッドは、指定したタグを持つ FA エントリを検索する場合は、そのタグに関連付けられているデータ型が EntryType で指定されたデータ型と互換性があるかどうかを確認します。たとえば、 DEBUG_FA_ENTRY_ULONG64、 DEBUG_FA_ENTRY_INSTRUCTION_OFFSET、 DEBUG_FA_ENTRY_POINTER はすべて相互に互換性があります。同様に、 DEBUG_FA_ENTRY_ANSI_STRING と DEBUG_FA_ENTRY_EXTENSION_CMD は相互に互換性があります。データ型に互換性がない場合、このメソッドは NULL を 返し、エントリのデータブロックを上書きしません。

このメソッドは、指定したタグを持つ FA エントリが見つからない場合は、そのタグを使用して新しい FA エントリを作成し、 タグを EntryType で指定されたデータ型に関連付けます。