Método IDebugEventCallbacksWide::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] PCWSTR  ModuleName,
  [in, optional] PCWSTR  ImageName,
  [in]           ULONG   CheckSum,
  [in]           ULONG   TimeDateStamp
);

Parámetros

[in] ImageFileHandle

Especifica el identificador del archivo de imagen del módulo. Si esta información no está disponible, ImageFileHandle se 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 se NULL.

[in] ModuleSize

Especifica el tamaño de imagen del módulo en bytes. Si esta información no está disponible, ModuleSize se 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 del archivo de imagen excluyendo la extensión. Si esta información no está disponible, ModuleName se 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 se 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 DEBUG_STATUS_XXX, que indica cómo debe continuar la ejecución del destino después de que el motor procese este evento. Para obtener más información sobre cómo el motor trata este valor, consulte Supervisión de eventos.

Observaciones

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

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

Para obtener más información sobre el control de eventos, consulte Supervisión de eventos.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	dbgeng.h (include Dbgeng.h)