PDEBUG_EXTENSION_INITIALIZE fonction de rappel (dbgeng.h)

Article
02/06/2025

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 principal, et les 16 bits faibles contiennent le numéro de version mineure.

[out] Flags

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

Valeur de retour

Retourner le code	Description
S_OK	L’extension a été initialisée.

Toute autre valeur indique que la DLL d’extension n’a pas pu être initialisé et que le moteur le 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.

Une session peut être active ou non lorsque cette fonction est appelée. Par conséquent, l’extension ne doit 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.