IDebugEventCallbacks::LoadModule, méthode (dbgeng.h)

La méthode de rappel LoadModule est appelée par le moteur lorsqu’un événement de débogage de chargement de module se produit dans la cible.

Syntaxe

HRESULT LoadModule(
  [in]           ULONG64 ImageFileHandle,
  [in]           ULONG64 BaseOffset,
  [in]           ULONG   ModuleSize,
  [in, optional] PCSTR   ModuleName,
  [in, optional] PCSTR   ImageName,
  [in]           ULONG   CheckSum,
  [in]           ULONG   TimeDateStamp
);

Paramètres

[in] ImageFileHandle

Spécifie le handle du fichier image du module. Si ces informations ne sont pas disponibles, ImageFileHandle est NULL.

[in] BaseOffset

Spécifie l’adresse de base du module dans l’espace d’adressage mémoire de la cible. Si ces informations ne sont pas disponibles, BaseOffset est NULL.

[in] ModuleSize

Spécifie la taille de l’image du module en octets. Si ces informations ne sont pas disponibles, ModuleSize est NULL.

[in, optional] ModuleName

Spécifie le nom de module simplifié utilisé par le moteur de débogueur. Dans la plupart des cas, cela correspond au nom du fichier image à l’exclusion de l’extension. Si ces informations ne sont pas disponibles, ModuleName est NULL.

[in, optional] ImageName

Spécifie le nom du fichier image du module, qui peut inclure le chemin d’accès. Si ces informations ne sont pas disponibles, ImageName est NULL.

[in] CheckSum

Spécifie la somme de contrôle du fichier image du module. Si ces informations ne sont pas disponibles, CheckSum est NULL.

[in] TimeDateStamp

Spécifie l’heure et l’horodatage du fichier image du module. Si ces informations ne sont pas disponibles, TimeDateStamp est égal à zéro.

Valeur de retour

Cette méthode retourne une valeur DEBUG_STATUS_XXX , qui indique comment l’exécution de la cible doit se poursuivre après que le moteur traite cet événement. Pour plus d’informations sur la façon dont le moteur traite cette valeur, consultez Surveillance des événements.

Remarques

Cette méthode est appelée uniquement par le moteur si l’indicateur DEBUG_EVENT_LOAD_MODULE est défini dans le masque retourné par IDebugEventCallbacks::GetInterestMask.

Après avoir appelé cette méthode, le moteur appelle IDebugEventCallbacks::ChangeSymbolState, avec le paramètre Flags contenant l’indicateur de bits DEBUG_CSS_LOADS.

Pour plus d’informations sur la gestion des événements, consultez Surveillance des événements.

Configuration requise

   
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (include Dbgeng.h)