Metodo IDebugEventCallbacks::LoadModule (dbgeng.h)

Articolo
02/06/2025

Il metodo di callback LoadModule viene chiamato dal motore quando si verifica un evento di debug del caricamento del modulo nella destinazione.

Sintassi

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

Parametri

[in] ImageFileHandle

Specifica l'handle per il file di immagine del modulo. Se queste informazioni non sono disponibili, ImageFileHandle verrà NULL.

[in] BaseOffset

Specifica l'indirizzo di base del modulo nello spazio indirizzi di memoria della destinazione. Se queste informazioni non sono disponibili, BaseOffset verrà NULL.

[in] ModuleSize

Specifica le dimensioni dell'immagine del modulo in byte. Se queste informazioni non sono disponibili, ModuleSize verrà NULL.

[in, optional] ModuleName

Specifica il nome del modulo semplificato utilizzato dal motore del debugger. Nella maggior parte dei casi, corrisponde al nome del file di immagine escluso l'estensione. Se queste informazioni non sono disponibili, ModuleName verrà NULL.

[in, optional] ImageName

Specifica il nome del file di immagine del modulo, che può includere il percorso. Se queste informazioni non sono disponibili, ImageName verrà NULL.

[in] CheckSum

Specifica il checksum del file di immagine del modulo. Se queste informazioni non sono disponibili, CheckSum verrà NULL.

[in] TimeDateStamp

Specifica l'ora e la data del file di immagine del modulo. Se queste informazioni non sono disponibili, timeDateStamp sarà zero.

Valore restituito

Questo metodo restituisce un valore DEBUG_STATUS_XXX, che indica il modo in cui l'esecuzione della destinazione deve procedere dopo l'elaborazione dell'evento da parte del motore. Per informazioni dettagliate sul modo in cui il motore gestisce questo valore, vedere Monitoraggio eventi.

Osservazioni

Questo metodo viene chiamato dal motore solo se il flag DEBUG_EVENT_LOAD_MODULE è impostato nella maschera restituita da IDebugEventCallbacks::GetInterestMask.

Dopo aver chiamato questo metodo, il motore chiamerà IDebugEventCallbacks::ChangeSymbolState, con il parametro Flags contenente il flag di bit DEBUG_CSS_LOADS.

Per altre informazioni sulla gestione degli eventi, vedere Monitoraggio eventi.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	dbgeng.h (include Dbgeng.h)

Condividi tramite