Condividi tramite


PDEBUG_EXTENSION_INITIALIZE funzione di callback (dbgeng.h)

La DebugExtensionInitialize funzione di callback viene chiamata dal motore dopo il caricamento di una DLL di 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 alti contengono il numero di versione principale e i 16 bit bassi contengono il numero di versione secondario.

[out] Flags

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

Valore restituito

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

Qualsiasi altro valore indica che la DLL dell'estensione non è stata in grado di inizializzare e il motore lo scarica.

Osservazioni

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 disponibile in dbgeng.h, ad esempio:

*Version = DEBUG_EXTENSION_VERSION(Major, Minor)

Le implementazioni di questa funzione devono inizializzare tutte le variabili globali richieste dalla DLL dell'estensione.

Quando viene chiamata questa funzione può essere attiva o meno, 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.

Fabbisogno

Requisito Valore
piattaforma di destinazione Universale
intestazione dbgeng.h

Vedere anche

DebugExtensionNotify

DebugExtensionUninitialize

KnownStructOutput