Metodo IDebugEventCallbacks::LoadModule (dbgeng.h)

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 sarà NULL.

[in] BaseOffset

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

[in] ModuleSize

Specifica le dimensioni dell'immagine del modulo in byte. Se queste informazioni non sono disponibili, ModuleSize sarà 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 sarà 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 sarà NULL.

[in] CheckSum

Specifica il checksum del file di immagine del modulo. Se queste informazioni non sono disponibili, CheckSum sarà 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 continuare dopo l'elaborazione dell'evento da parte del motore. Per informazioni dettagliate sul modo in cui il motore gestisce questo valore, vedere Monitoraggio degli eventi.

Commenti

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 degli eventi.

Requisiti

   
Piattaforma di destinazione Desktop
Intestazione dbgeng.h (include Dbgeng.h)