IDebugFailureAnalysis2::SetBuffer-Methode (extsfns.h)
Die SetBuffer-Methode durchsucht ein DebugFailureAnalysis-Objekt nach dem ersten FA-Eintrag , der über ein angegebenes Tag verfügt. Wenn ein FA-Eintrag mit dem angegebenen Tag gefunden wird, wird der Datenblock des FA-Eintrags mit den Bytes in einem angegebenen Puffer überschrieben. Wenn diese Methode keinen FA-Eintrag mit dem angegebenen Tag findet, erstellt sie einen neuen FA-Eintrag mit diesem Tag und überschreibt den Datenblock des neuen FA-Eintrags mit den Daten im angegebenen Puffer.
Syntax
PFA_ENTRY SetBuffer(
FA_TAG Tag,
[in] FA_ENTRY_TYPE EntryType,
[in] PVOID Buf,
[in] ULONG Size
);
Parameter
Tag
Ein -Wert in der FA_TAG-Enumeration .
[in] EntryType
Ein -Wert in der FA_ENTRY_TYPE-Enumeration . Dieser Parameter gibt den Datentyp der Daten in Buf an.
[in] Buf
Ein Zeiger auf einen Puffer, der die Bytes enthält, die in den Datenblock des neuen oder vorhandenen FA-Eintrags geschrieben werden sollen.
[in] Size
Die Größe des Puffers in Bytes, auf den Buf verweist.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird ein Zeiger auf die neue oder vorhandene FA_ENTRY-Struktur zurückgegeben. Andernfalls wird NULL zurückgegeben.
Hinweise
Wenn diese Methode einen FA-Eintrag mit dem angegebenen Tag findet, überprüft sie, ob der diesem Tag zugeordnete Datentyp mit dem durch EntryType angegebenen Datentyp kompatibel ist. Beispielsweise sind DEBUG_FA_ENTRY_ULONG64, DEBUG_FA_ENTRY_INSTRUCTION_OFFSET und DEBUG_FA_ENTRY_POINTER miteinander kompatibel. Ebenso sind DEBUG_FA_ENTRY_ANSI_STRING und DEBUG_FA_ENTRY_EXTENSION_CMD miteinander kompatibel. Wenn die Datentypen nicht kompatibel sind, gibt diese Methode NULL zurück und überschreibt den Datenblock des Eintrags nicht.
Wenn diese Methode keinen FA-Eintrag mit dem angegebenen Tag findet, erstellt sie einen neuen FA-Eintrag mit diesem Tag und ordnet das Tag dem durch EntryType angegebenen Datentyp zu.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | extsfns.h |
Weitere Informationen
Schreiben eines Analyseerweiterungs-Plug-Ins zum Erweitern von !analyze