IDebugFailureAnalysis2：：SetBuffer 方法 (extsfns.h)

项目
02/29/2024

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或现有 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 指定的数据类型相关联。