IDebugEventCallbacks::LoadModule 方法 (dbgeng.h)

當目標中發生模組載入偵錯事件時,引擎會呼叫 LoadModule 回呼方法。

語法

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

參數

[in] ImageFileHandle

指定模組映像檔的句柄。 如果此資訊無法使用, ImageFileHandle 會是 NULL

[in] BaseOffset

指定目標記憶體位址空間中模組的基位址。 如果這項信息無法使用, BaseOffset 會是 NULL

[in] ModuleSize

以位元組為單位指定模組的映像大小。 如果無法使用這項資訊, ModuleSize 將會是 NULL

[in, optional] ModuleName

指定調試程式引擎所使用的簡化模組名稱。 在大部分情況下,這會比對排除擴展名的映像檔名。 如果這項信息無法使用, ModuleName 會是 NULL

[in, optional] ImageName

指定模組的映像檔名稱,其中包含路徑。 如果此資訊無法使用, ImageName 將會是 NULL

[in] CheckSum

指定模組映像檔的總和檢查碼。 如果這項信息無法使用, CheckSum 將會是 NULL

[in] TimeDateStamp

指定模組映像檔的時間和日期戳記。 如果無法使用這項資訊, TimeDateStamp 將會是零。

傳回值

這個方法會傳回 DEBUG_STATUS_XXX 值,這個值表示引擎處理此事件之後,應該如何繼續執行目標。 如需引擎如何處理此值的詳細資訊,請參閱 監視事件

備註

只有在 IDebugEventCallbacks::GetInterestMask 所傳回的遮罩中設定DEBUG_EVENT_LOAD_MODULE旗標時,引擎才會呼叫這個方法。

呼叫此方法之後,引擎會呼叫 IDebugEventCallbacks::ChangeSymbolState,並使用包含位旗標的 Flags 參數DEBUG_CSS_LOADS。

如需處理事件的詳細資訊,請參閱 監視事件

規格需求

需求
目標平台 桌面
標頭 dbgeng.h (包含 Dbgeng.h)