PWINDBG_EXTENSION_DLL_INIT Rückruffunktion (wdbgexts.h)

Die Rückruffunktion PWINDBG_EXTENSION_DLL_INIT ( WinDbgExtensionDllInit) 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 Ihrer DLL. Sie können beispielsweise eine globale Variable mit dem Namen ExtensionApis erstellen, wie im folgenden Beispiel gezeigt.

WINDBG_EXTENSION_APIS64   ExtensionApis;

MajorVersion

Gibt den Microsoft Windows-Buildtyp an. Der Wert 0xC gibt den überprüften Build von Windows an. Der Wert 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 mit dem Namen 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 mit dem Namen SavedMinorVersion erstellen.

Rückgabewert

Keine

Bemerkungen

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

Es wird empfohlen, immer 64-Bit-Zeiger im 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 sich jedoch für die Verwendung von 32-Bit-Zeigern entscheiden, weist der erste Parameter von WinDbgExtensionDllInit den Typ PWINDBG_EXTENSION_APIS anstelle von PWINDBG_EXTENSION_APIS64 auf.

Weitere Informationen finden Sie unter Verwenden von WdbgExts-Erweiterungsrückrufen.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	wdbgexts.h