PDEBUG_EXTENSION_INITIALIZE fonction de rappel (dbgeng.h)

Article
02/23/2024

La fonction de rappel DebugExtensionInitialize est appelée par le moteur après le chargement d’une DLL d’extension DbgEng.

 CALLBACK* PDEBUG_EXTENSION_INITIALIZE DebugExtensionInitialize;

Syntaxe

PDEBUG_EXTENSION_INITIALIZE PdebugExtensionInitialize;

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

Paramètres

[out] Version

Reçoit la version de l’extension. Les 16 bits élevés contiennent le numéro de version principale et les 16 bits inférieurs contiennent le numéro de version secondaire.

[out] Flags

Définissez cette valeur sur zéro. (Réservé pour une utilisation ultérieure.)

Valeur retournée

Code de retour	Description
S_OK	L’extension a été initialisée avec succès.

Toute autre valeur indique que la DLL d’extension n’a pas pu s’initialiser et que le moteur la déchargera.

Remarques

Le moteur recherche cette fonction par nom dans chaque DLL d’extension. Cette fonction doit être exportée par une DLL d’extension DbgEng.

Le numéro de version peut être défini à l’aide de la macro DEBUG_EXTENSION_VERSION trouvée dans dbgeng.h, par exemple :

*Version = DEBUG_EXTENSION_VERSION(Major, Minor)

Les implémentations de cette fonction doivent initialiser toutes les variables globales requises par la DLL d’extension.

Il se peut qu’il n’y ait pas de session active lorsque cette fonction est appelée. L’extension ne doit donc pas supposer qu’elle est en mesure d’interroger les informations de session.

Le type de fonction est défini comme PDEBUG_EXTENSION_INITIALIZE dans dbgeng.h.