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) |
意見反應
https://aka.ms/ContentUserFeedback。
即將推出:在 2024 年,我們將隨著內容的意見反應機制逐步淘汰 GitHub 問題,並以新的意見反應系統來取代。 如需詳細資訊,請參閱提交並檢視相關的意見反應