次の方法で共有

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

戻り値

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

注釈

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

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

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

要件

要件 値
対象プラットフォーム デスクトップ
Header dbgeng.h (Dbgeng.h を含む)