PWINDBG_EXTENSION_API_VERSION Rückruffunktion (wdbgexts.h)

Die rückruffunktion PWINDBG_EXTENSION_API_VERSION (ExtensionApiVersion) gibt Versionsinformationen zur Erweiterungs-DLL zurück.

Syntax

PWINDBG_EXTENSION_API_VERSION PwindbgExtensionApiVersion;

LPEXT_API_VERSION PwindbgExtensionApiVersion()
{...}

Rückgabewert

Diese Funktion muss einen Zeiger auf eine EXT_API_VERSION Struktur zurückgeben.

Bemerkungen

Sie müssen diese Funktion im Code mithilfe des obigen Prototyps definieren. Schließen Sie wdbgexts.h ein.

ExtensionApiVersion- wird vom Debugger aufgerufen, wenn die Erweiterungs-DLL geladen wird.

Der Debugger verwendet die Felder MajorVersion und MinorVersion der zurückgegebenen EXT_API_VERSION Struktur beim Ausführen von Befehlen wie .chain- und Version, die die Versionsnummer der Erweiterung anzeigen. Der Debugger führt keine "Versionsüberprüfung" durch – die Erweiterungs-DLL wird geladen, unabhängig davon, welche Versionsnummern in diesen Feldern vorhanden sind.

Das feld Revision der zurückgegebenen EXT_API_VERSION Struktur sollte EXT_API_VERSION_NUMBER64 werden, wenn Sie 64-Bit-Zeiger in Ihrem Code verwenden, oder EXT_API_VERSION_NUMBER32, wenn Sie 32-Bit-Zeiger verwenden. Es wird empfohlen, immer 64-Bit-Zeiger in Ihrem Code zu verwenden, da der Debugger diese Zeiger bei Bedarf automatisch ändert. Weitere Informationen finden Sie unter 32-Bit-Zeiger und 64-Bit-Zeiger.

Weitere Informationen finden Sie unter Verwenden von WdbgExts Extension Callbacks.

Anforderungen