PDEBUG_EXTENSION_INITIALIZE funzione di callback (dbgeng.h)
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 |
|---|---|
|
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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | dbgeng.h |