IDebugFailureAnalysis::GetBuffer-Methode (extsfns.h)

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.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile extsfns.h

Weitere Informationen

AddBuffer

IDebugFailureAnalysis2

SetBuffer

Schreiben eines Analyseerweiterungs-Plug-Ins zum Erweitern von !analyze

_EFN_Analyze