Metodo IDebugFailureAnalysis2::SetBuffer (extsfns.h)

Articolo
02/06/2025

Il metodo SetBuffer cerca un oggetto DebugFailureAnalysis per la prima voce fa con un tag specificato. Se trova una voce FA con il tag specificato, sovrascrive il blocco di dati della voce FA con i byte in un buffer specificato. Se questo metodo non trova una voce fa con il tag specificato, crea una nuova voce FA con tale tag e sovrascrive il blocco di dati della nuova voce FA con i dati nel buffer specificato.

Sintassi

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

Parametri

Tag

Valore nell'enumerazione FA_TAG.

[in] EntryType

Valore nell'enumerazione FA_ENTRY_TYPE. Questo parametro specifica il tipo di dati in Buf.

[in] Buf

Puntatore a un buffer contenente i byte da scrivere nel blocco di dati della voce fa nuova o esistente.

[in] Size

Dimensione, in byte, del buffer a cui punta Buf.

Valore restituito

Se questo metodo ha esito positivo, restituisce un puntatore alla struttura FA_ENTRY nuova o esistente. In caso contrario, restituisce NULL.

Osservazioni

Se questo metodo trova un voce FA con il tag specificato, verifica se il tipo di dati associato a tale tag è compatibile con il tipo di dati specificato da EntryType. Ad esempio, DEBUG_FA_ENTRY_ULONG64, DEBUG_FA_ENTRY_INSTRUCTION_OFFSETe DEBUG_FA_ENTRY_POINTER sono tutti compatibili tra loro. Analogamente, DEBUG_FA_ENTRY_ANSI_STRING e DEBUG_FA_ENTRY_EXTENSION_CMD sono compatibili tra loro. Se i tipi di dati non sono compatibili, questo metodo restituisce NULL e non sovrascrive il blocco di dati della voce.

Se questo metodo non trova una voce fa con il tag specificato, crea una nuova voce FA con tale tag e associa il tag al tipo di dati specificato da EntryType.