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 は 0 になります。

戻り値

このメソッドは、DEBUG_STATUS_XXX 値を返します。これは、エンジンがこのイベントを処理した後にターゲットの実行を続行する方法を示します。 エンジンによるこの値の処理方法の詳細については、「監視イベントの」を参照してください。

備考

このメソッドは、DEBUG_EVENT_LOAD_MODULE フラグが IDebugEventCallbacks::GetInterestMask によって返されるマスク設定されている場合にのみ、エンジンによって呼び出されます。

このメソッドを呼び出すと、エンジンは IDebugEventCallbacks::ChangeSymbolState を呼び出し、ビット フラグ DEBUG_CSS_LOADSを含む Flags パラメーターを使用します。

イベントの処理の詳細については、「監視イベントの」を参照してください。

必要条件

要件	価値
ターゲット プラットフォーム の	デスクトップ
ヘッダー	dbgeng.h (Dbgeng.h を含む)