SetBuffer メソッドは、DebugFailureAnalysis オブジェクトで、指定したタグを持つ最初の FA エントリ を検索します。 指定したタグを持つ 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で指定されたデータ型にタグを関連付けます。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | extsfns.h |
関連項目
AddBuffer の
GetBuffer の