PWINDBG_EXTENSION_DLL_INIT Rückruffunktion (wdbgexts.h)

Artikel
02/07/2025

Die PWINDBG_EXTENSION_DLL_INIT ( WinDbgExtensionDllInit) Rückruffunktion wird verwendet, um das Erweiterungsmodul zu laden und zu initialisieren.

Syntax

PWINDBG_EXTENSION_DLL_INIT PwindbgExtensionDllInit;

void PwindbgExtensionDllInit(
  PWINDBG_EXTENSION_APIS lpExtensionApis,
  USHORT MajorVersion,
  USHORT MinorVersion
)
{...}

Parameter

lpExtensionApis

Ein Zeiger auf eine WINDBG_EXTENSION_APIS64 Struktur, die Zeiger auf Funktionen enthält, die Sie für Standardvorgänge verwenden können. Kopieren Sie die gesamte Struktur in eine globale Variable in Der DLL. Sie können z. B. eine globale Variable mit dem Namen ExtensionApis erstellen, wie im folgenden Beispiel gezeigt.

WINDBG_EXTENSION_APIS64   ExtensionApis;

MajorVersion

Gibt den Microsoft Windows-Buildtyp an. Ein Wert von 0xC gibt den überprüften Build von Windows an. Ein Wert von 0xF gibt den kostenlosen Build von Windows an. Speichern Sie diesen Wert in einer globalen Variablen in Ihrer DLL. Sie können beispielsweise eine globale Variable namens SavedMajorVersion erstellen.

MinorVersion

Gibt die Windows-Buildnummer (z. B. 2600) des Zielsystems an. Speichern Sie diesen Wert in einer globalen Variablen in Ihrer DLL. Sie können beispielsweise eine globale Variable namens SavedMinorVersion erstellen.

Rückgabewert

Nichts

Bemerkungen

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

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. Wenn Sie jedoch 32-Bit-Zeiger verwenden, hat der erste Parameter von WinDbgExtensionDllInit den Typ PWINDBG_EXTENSION_APIS anstelle von PWINDBG_EXTENSION_APIS64.

Weitere Informationen finden Sie unter Verwenden von WdbgExts Extension Callbacks.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	wdbgexts.h

Freigeben über