IDebugFailureAnalysis::GetBuffer-Methode (extsfns.h)

Artikel
02/26/2024

Die GetBuffer-Methode durchsucht ein DebugFailureAnalysis-Objekt nach dem ersten FA-Eintrag mit einem angegebenen Tag. Wenn ein FA-Eintrag mit dem angegebenen Tag gefunden wird, wird der Datenblock des Eintrags abgerufen.

Syntax

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

Parameter

[in] Tag

Ein Wert in der FA_TAG-Enumeration .

[out] Buf

Ein Zeiger auf einen Puffer, der den Datenblock des Eintrags empfängt.

[in] Size

Die Größe des Puffers in Bytes, auf den Buf verweist.

Rückgabewert

Wenn diese Methode einen FA-Eintrag mit dem angegebenen Tag findet und der Datenblock erfolgreich abrufen kann, gibt sie einen Zeiger auf die FA_ENTRY-Struktur zurück. Andernfalls wird NULL zurückgegeben.

Hinweise

Wenn diese Methode einen FA-Eintrag mit dem angegebenen Tag findet, überprüft sie, ob das DataSize-Element der FA_ENTRY-Struktur dem vom Size-Parameter angegebenen Wert entspricht. Wenn DataSize nicht gleich Size ist, gibt diese Methode NULL zurück und ruft den Datenblock nicht ab.