PWINDBG_EXTENSION_DLL_INIT fonction de rappel (wdbgexts.h)

La fonction de rappel PWINDBG_EXTENSION_DLL_INIT ( WinDbgExtensionDllInit) est utilisée pour charger et initialiser le module d’extension.

Syntaxe

PWINDBG_EXTENSION_DLL_INIT PwindbgExtensionDllInit;

void PwindbgExtensionDllInit(
  PWINDBG_EXTENSION_APIS lpExtensionApis,
  USHORT MajorVersion,
  USHORT MinorVersion
)
{...}

Paramètres

lpExtensionApis

Pointeur vers une structure WINDBG_EXTENSION_APIS64, qui contient des pointeurs vers des fonctions que vous pouvez utiliser pour les opérations standard. Copiez l’ensemble de la structure dans une variable globale dans votre DLL. Par exemple, vous pouvez créer une variable globale nommée ExtensionApis, comme illustré dans l’exemple suivant.

WINDBG_EXTENSION_APIS64   ExtensionApis;

MajorVersion

Spécifie le type de build Microsoft Windows. La valeur 0xC indique la build vérifiée de Windows. La valeur 0xF indique la build gratuite de Windows. Enregistrez cette valeur dans une variable globale dans votre DLL. Par exemple, vous pouvez créer une variable globale nommée SavedMajorVersion.

MinorVersion

Spécifie le numéro de build Windows (par exemple 2600) du système cible. Enregistrez cette valeur dans une variable globale dans votre DLL. Par exemple, vous pouvez créer une variable globale nommée SavedMinorVersion.

Valeur de retour

None

Remarques

WinDbgExtensionDllInit est appelé par le débogueur lorsque la DLL d’extension est chargée.

Il est recommandé de toujours utiliser des pointeurs 64 bits dans votre code, car le débogueur redimensionne automatiquement ces pointeurs si nécessaire. Pour plus d’informations, consultez Pointeurs 32 bits et Pointeurs 64 bits . Toutefois, si vous choisissez d’utiliser des pointeurs 32 bits, le premier paramètre de WinDbgExtensionDllInit aura le type PWINDBG_EXTENSION_APIS au lieu de PWINDBG_EXTENSION_APIS64.

Pour plus d’informations, consultez Utilisation des rappels d’extension WdbgExts.

Configuration requise