PDEBUG_EXTENSION_INITIALIZE funzione di callback (dbgeng.h)

Articolo
02/23/2024

La funzione di callback DebugExtensionInitialize viene chiamata dal motore dopo il caricamento di una DLL dell'estensione DbgEng.

 CALLBACK* PDEBUG_EXTENSION_INITIALIZE DebugExtensionInitialize;

Sintassi

PDEBUG_EXTENSION_INITIALIZE PdebugExtensionInitialize;

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

Parametri

[out] Version

Riceve la versione dell'estensione. I 16 bit elevati contengono il numero di versione principale e i 16 bit bassi contengono il numero di versione secondaria.

[out] Flags

Impostare questo valore su zero. (Riservato per l'uso futuro).

Valore restituito

Codice restituito	Descrizione
S_OK	L'estensione è stata inizializzata correttamente.

Qualsiasi altro valore indica che la DLL dell'estensione non è riuscita a inizializzare e il motore lo scarica.

Commenti

Il motore cerca questa funzione in base al nome in ogni DLL di estensione. Questa funzione deve essere esportata da una DLL di estensione DbgEng.

Il numero di versione può essere impostato usando la macro DEBUG_EXTENSION_VERSION trovata in dbgeng.h, ad esempio:

*Version = DEBUG_EXTENSION_VERSION(Major, Minor)

Le implementazioni di questa funzione devono inizializzare qualsiasi variabile globale richiesta dalla DLL dell'estensione.

Potrebbe essere presente o meno una sessione attiva quando questa funzione viene chiamata, quindi l'estensione non deve presupporre che sia in grado di eseguire query sulle informazioni sulla sessione.

Il tipo di funzione è definito come PDEBUG_EXTENSION_INITIALIZE in dbgeng.h.