Compartir a través de


Método IDebugEventCallbacks::LoadModule (dbgeng.h)

El motor llama al método de devolución de llamada LoadModule cuando se produce un evento de depuración de carga de módulos en el destino.

Sintaxis

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
);

Parámetros

[in] ImageFileHandle

Especifica el identificador para el archivo de imagen del módulo. Si esta información no está disponible, ImageFileHandle será NULL.

[in] BaseOffset

Especifica la dirección base del módulo en el espacio de direcciones de memoria del destino. Si esta información no está disponible, BaseOffset será NULL.

[in] ModuleSize

Especifica el tamaño de imagen del módulo en bytes. Si esta información no está disponible, ModuleSize será NULL.

[in, optional] ModuleName

Especifica el nombre del módulo simplificado que usa el motor del depurador. En la mayoría de los casos, esto coincide con el nombre de archivo de imagen excluyendo la extensión. Si esta información no está disponible, ModuleName será NULL.

[in, optional] ImageName

Especifica el nombre del archivo de imagen del módulo, que puede incluir la ruta de acceso. Si esta información no está disponible, ImageName será NULL.

[in] CheckSum

Especifica la suma de comprobación del archivo de imagen del módulo. Si esta información no está disponible, CheckSum será NULL.

[in] TimeDateStamp

Especifica la marca de fecha y hora del archivo de imagen del módulo. Si esta información no está disponible, TimeDateStamp será cero.

Valor devuelto

Este método devuelve un valor de DEBUG_STATUS_XXX , que indica cómo debe continuar la ejecución del destino después de que el motor procese este evento. Para más información sobre cómo trata el motor este valor, consulte Supervisión de eventos.

Comentarios

El motor solo llama a este método si la marca DEBUG_EVENT_LOAD_MODULE está establecida en la máscara devuelta por IDebugEventCallbacks::GetInterestMask.

Después de llamar a este método, el motor llamará a IDebugEventCallbacks::ChangeSymbolState, con el parámetro Flags que contiene la marca de bits DEBUG_CSS_LOADS.

Para obtener más información sobre cómo controlar eventos, consulte Supervisión de eventos.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include Dbgeng.h)