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

Artigo
02/06/2025

O método de retorno de chamada LoadModule é chamado pelo mecanismo quando ocorre um evento de depuração de carga de módulo no destino.

Sintaxe

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 o identificador do arquivo de imagem do módulo. Se essas informações não estiverem disponíveis, ImageFileHandle será NULL.

[in] BaseOffset

Especifica o endereço base do módulo no espaço de endereço de memória do destino. Se essas informações não estiverem disponíveis, BaseOffset será NULL.

[in] ModuleSize

Especifica o tamanho da imagem do módulo em bytes. Se essas informações não estiverem disponíveis, ModuleSize serão NULL.

[in, optional] ModuleName

Especifica o nome do módulo simplificado que é usado pelo mecanismo de depurador. Na maioria dos casos, isso corresponde ao nome do arquivo de imagem, excluindo a extensão. Se essas informações não estiverem disponíveis, ModuleName será NULL.

[in, optional] ImageName

Especifica o nome do arquivo de imagem do módulo, que pode incluir o caminho. Se essas informações não estiverem disponíveis, ImageName será NULL.

[in] CheckSum

Especifica a soma de verificação do arquivo de imagem do módulo. Se essas informações não estiverem disponíveis, CheckSum será NULL.

[in] TimeDateStamp

Especifica o carimbo de data e hora do arquivo de imagem do módulo. Se essas informações não estiverem disponíveis, TimeDateStamp será zero.

Valor de retorno

Esse método retorna um valor DEBUG_STATUS_XXX, que indica como a execução do destino deve continuar depois que o mecanismo processa esse evento. Para obter detalhes sobre como o mecanismo trata esse valor, consulte Eventos de Monitoramento.

Observações

Esse método só será chamado pelo mecanismo se o sinalizador de DEBUG_EVENT_LOAD_MODULE for definido na máscara retornada por IDebugEventCallbacks::GetInterestMask.

Depois de chamar esse método, o mecanismo chamará IDebugEventCallbacks::ChangeSymbolState, com o parâmetro Flags contendo o sinalizador de bit DEBUG_CSS_LOADS.

Para obter mais informações sobre como lidar com eventos, consulte Eventos de Monitoramento.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Compartilhar via