IDebugClient3::WriteDumpFile2 メソッド (dbgeng.h)

[アーティクル]
02/06/2025

WriteDumpFile2 メソッドは、ユーザーモードまたはカーネルモードのダンプファイルを作成します。

構文

HRESULT WriteDumpFile2(
  [in]           PCSTR DumpFile,
  [in]           ULONG Qualifier,
  [in]           ULONG FormatFlags,
  [in, optional] PCSTR Comment
);

パラメーター

[in] DumpFile

作成するダンプファイルの名前を指定します。 DumpFile ファイル名拡張子を含める必要があります。 DumpFile 相対パスまたは絶対パスを含めることができます。相対パスは、デバッガーが開始されたディレクトリに対する相対パスです。

[in] Qualifier

作成するダンプファイルの種類を指定します。使用可能な値については、DEBUG_DUMP_XXXを参照してください。

[in] FormatFlags

ダンプファイルの形式を決定するフラグを指定し、ユーザーモードのミニダンプの場合は、ファイルに含める情報を指定します。詳細については、「解説」を参照してください。

[in, optional] Comment

クラッシュダンプファイルに含めるコメント文字列を指定します。この文字列は、ダンプファイルが読み込まれるとデバッガーコンソールに表示されます。一部のダンプファイル形式では、コメント文字列の格納がサポートされていません。

戻り値

このメソッドは、エラー値を返す場合もあります。詳細については戻り値のを参照してください。

リターンコード	形容
S_OK	メソッドが成功しました。

備考

DEBUG_FORMAT_XXX ビットフラグは、WriteDumpFile2 および WriteDumpFileWide をして、クラッシュダンプファイルの形式と、ユーザーモードのミニダンプに含める情報を決定するために使用されます。

次のビットフラグは、すべてのクラッシュダンプファイルに適用されます。

価値	形容
DEBUG_FORMAT_WRITE_CAB	クラッシュダンプファイルを CAB ファイルにパッケージ化します。指定されたファイル名またはファイルハンドルが CAB ファイルに使用されます。クラッシュダンプは、CAB ファイルに移動される前に最初に一時ファイルに作成されます。
DEBUG_FORMAT_CAB_SECONDARY_FILES	CAB ファイルに現在のシンボルとマップされたイメージを含めます。 DEBUG_FORMAT_WRITE_CABが設定されていない場合、このフラグは無視されます。
DEBUG_FORMAT_NO_OVERWRITE	既存のファイルは上書きしないでください。

ユーザーモードのミニダンプには、次のビットフラグを含めることもできます。

価値	形容
DEBUG_FORMAT_USER_SMALL_FULL_MEMORY	完全なメモリデータを追加します。ターゲットアプリケーションが所有するすべてのアクセス可能なコミット済みページが含まれます。
DEBUG_FORMAT_USER_SMALL_HANDLE_DATA	ターゲットアプリケーションに関連付けられているハンドルに関するデータを追加します。
DEBUG_FORMAT_USER_SMALL_UNLOADED_MODULES	アンロードされたモジュール情報を追加します。この情報は、Windows Server 2003 以降のバージョンの Windows でのみ使用できます。
DEBUG_FORMAT_USER_SMALL_INDIRECT_MEMORY	間接メモリを追加します。スタックまたはバッキングストア上のポインターによって参照されるアドレスを囲むメモリの小さな領域が含まれます。
DEBUG_FORMAT_USER_SMALL_DATA_SEGMENTS	実行可能イメージ内のすべてのデータセグメントを追加します。
DEBUG_FORMAT_USER_SMALL_FILTER_MEMORY	スタックトレースを再作成するのに役立たない、スタックとバッキングストア上のすべてのメモリを 0 に設定します。これにより、不要な情報を削除することで、ミニダンプの圧縮をより効率的にし、プライバシーを向上させることができます。
DEBUG_FORMAT_USER_SMALL_FILTER_PATHS	モジュール名のみを残して、モジュールパスを削除します。これは、ディレクトリ構造 (ユーザーの名前を含む可能性があります) を非表示にしてプライバシーを保護する場合に役立ちます。
DEBUG_FORMAT_USER_SMALL_PROCESS_THREAD_DATA	プロセス環境ブロック (PEB) とスレッド環境ブロック (TEB) を追加します。このフラグを使用して、スレッドとプロセスの Windows システム情報を提供できます。
DEBUG_FORMAT_USER_SMALL_PRIVATE_READ_WRITE_MEMORY	コミットされたすべてのプライベート読み取り/書き込みメモリページを追加します。
DEBUG_FORMAT_USER_SMALL_NO_OPTIONAL_DATA	プライバシーに依存するデータがミニダンプに含まれるのを防ぎます。現在、このフラグは、次のフラグが設定されているために追加されたミニダンプデータから除外されます。 DEBUG_FORMAT_USER_SMALL_PROCESS_THREAD_DATA、 DEBUG_FORMAT_USER_SMALL_FULL_MEMORY、 DEBUG_FORMAT_USER_SMALL_INDIRECT_MEMORY、 DEBUG_FORMAT_USER_SMALL_PRIVATE_READ_WRITE_MEMORY。
DEBUG_FORMAT_USER_SMALL_FULL_MEMORY_INFO	すべての基本的なメモリ情報を追加します。これは、QueryVirtual メソッドによって返される情報です。有効なメモリだけでなく、すべてのメモリの情報が含まれています。これにより、デバッガーはミニダンプから完全な仮想メモリレイアウトを再構築できます。
DEBUG_FORMAT_USER_SMALL_THREAD_INFO	実行時間、開始時刻、終了時刻、開始アドレス、終了状態などのスレッド情報を追加します。
DEBUG_FORMAT_USER_SMALL_CODE_SEGMENTS	実行可能イメージを使用して、すべてのコードセグメントを追加します。

クラッシュダンプファイルの詳細については、「Dump-File ターゲット」を参照してください。

必要条件

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

次の方法で共有

IDebugClient3::WriteDumpFile2 メソッド (dbgeng.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース