IDebugFailureAnalysis2：：SetBuffer 方法（extsfns.h）

發行項
02/06/2025

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 所指向之緩衝區的大小，以位元組為單位，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 所指定的數據類型產生關聯。