PDEBUG_EXTENSION_INITIALIZE Rückruffunktion (dbgeng.h)

Die DebugExtensionInitialize Rückruffunktion wird vom Modul aufgerufen, nachdem eine DbgEng-Erweiterungs-DLL geladen wurde.

 CALLBACK* PDEBUG_EXTENSION_INITIALIZE DebugExtensionInitialize;

Syntax

PDEBUG_EXTENSION_INITIALIZE PdebugExtensionInitialize;

HRESULT PdebugExtensionInitialize(
  [out] PULONG Version,
  [out] PULONG Flags
)
{...}

Parameter

[out] Version

Empfängt die Version der Erweiterung. Die hohen 16 Bit enthalten die Hauptversionsnummer, und die niedrigen 16 Bit enthalten die Nebenversionsnummer.

[out] Flags

Legen Sie dies auf Null fest. (Reserviert für zukünftige Verwendung.)

Rückgabewert

Jeder andere Wert gibt an, dass die Erweiterungs-DLL nicht initialisiert werden konnte, und das Modul entlädt sie.

Bemerkungen

Das Modul sucht diese Funktion anhand des Namens in jeder Erweiterungs-DLL. Diese Funktion muss von einer DbgEng-Erweiterungs-DLL exportiert werden.

Die Versionsnummer kann mithilfe des Makros DEBUG_EXTENSION_VERSION in dbgeng.h festgelegt werden, z. B.:

*Version = DEBUG_EXTENSION_VERSION(Major, Minor)

Implementierungen dieser Funktion sollten alle globalen Variablen initialisieren, die von der Erweiterungs-DLL benötigt werden.

Es kann eine Sitzung aktiv sein, wenn diese Funktion aufgerufen wird, daher sollte die Erweiterung nicht davon ausgehen, dass sitzungsinformationen abgerufen werden können.

Der Funktionstyp wird als PDEBUG_EXTENSION_INITIALIZE in dbgeng.h definiert.

Anforderungen

Siehe auch

DebugExtensionNotify

DebugExtensionUninitialize

KnownStructOutput-