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)