Metodo IDebugFailureAnalysis::GetBuffer (extsfns.h)

Articolo
02/06/2025

Il metodo GetBuffer cerca un oggetto DebugFailureAnalysis per la prima voce fa con un tag specificato. Se trova una voce FA con il tag specificato, ottiene il blocco di dati della voce.

Sintassi

PFA_ENTRY GetBuffer(
  [in]  FA_TAG Tag,
  [out] PVOID  Buf,
  [in]  ULONG  Size
);

Parametri

[in] Tag

Valore nell'enumerazione FA_TAG.

[out] Buf

Puntatore a un buffer che riceve il blocco di dati della voce.

[in] Size

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

Valore restituito

Se questo metodo trova una voce FA con il tag specificato e, se riesce a ottenere il blocco di dati, restituisce un puntatore alla struttura FA_ENTRY. In caso contrario, restituisce NULL.

Osservazioni

Se questo metodo trova una voce FA con il tag specificato, verifica se il membro DataSize della struttura FA_ENTRY è uguale al valore specificato dal parametro Size. Se DataSize non è uguale a Size, questo metodo restituisce NULL e non ottiene il blocco di dati.