Método IDebugEventCallbacks::LoadModule (dbgeng.h)
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) |