IDebugFailureAnalysis::GetBuffer-Methode (extsfns.h)

Artikel
02/06/2025

Die GetBuffer--Methode durchsucht ein DebugFailureAnalysis--Objekt für den ersten FA-Eintrag mit einem angegebenen Tag. Wenn ein FA-Eintrag mit dem angegebenen Tag gefunden wird, ruft er den Datenblock des Eintrags ab.

Syntax

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

Parameter

[in] Tag

Ein Wert in der FA_TAG-Aufzählung.

[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 Bufverweist.

Rückgabewert

Wenn diese Methode einen FA-Eintrag mit dem angegebenen Tag findet und es erfolgreich ist, den Datenblock abzurufen, wird ein Zeiger auf die FA_ENTRY-Struktur zurückgegeben. Andernfalls wird NULL-zurückgegeben.

Bemerkungen

Wenn diese Methode einen FA-Eintrag mit dem angegebenen Tag findet, wird überprüft, ob das DataSize Member der FA_ENTRY Struktur dem wert entspricht, der durch den Parameter Size angegeben wird. Wenn DataSize- nicht gleich Sizeist, gibt diese Methode NULL- zurück und ruft den Datenblock nicht ab.