共用方式為

IDebugEventCallbacksWide：：LoadModule 方法 （dbgeng.h）

  • 發行項

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

語法

HRESULT LoadModule(
  [in]           ULONG64 ImageFileHandle,
  [in]           ULONG64 BaseOffset,
  [in]           ULONG   ModuleSize,
  [in, optional] PCWSTR  ModuleName,
  [in, optional] PCWSTR  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 值，指出引擎處理此事件之後，目標的執行應該如何繼續。 如需引擎如何處理此值的詳細資訊，請參閱 監視事件。

言論

只有在 IDebugEventCallbacksWide：：GetInterestMask 傳回的遮罩中設定了DEBUG_EVENT_LOAD_MODULE旗標時，引擎才會呼叫這個方法。

呼叫此方法之後，引擎會呼叫 IDebugEventCallbacksWide：：ChangeSymbolState，並具有包含位旗標DEBUG_CSS_LOADS的 Flags 參數。

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

要求

要求 價值
目標平臺 桌面
標頭 dbgeng.h （include Dbgeng.h）