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

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

構文

HRESULT WriteDumpFile(
  [in] PCSTR DumpFile,
  [in] ULONG Qualifier
);

[in] DumpFile

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

[in] Qualifier

作成するダンプファイルの種類を指定します。指定できる値については、「解説」を参照してください。

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

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

DEBUG_DUMP_XXX 定数は、WriteDumpFile 、WriteDumpFile2 、WriteDumpFileWide をして、作成するクラッシュダンプファイルの種類を指定するメソッドによって使用されます。

指定できる値は次のとおりです。

定数	形容
DEBUG_DUMP_SMALL	小さなメモリダンプ (カーネルモード) またはミニダンプ (ユーザーモード) を作成します。
DEBUG_DUMP_DEFAULT	フル User-Mode ダンプ (ユーザーモード) またはカーネルサマリーダンプ (カーネルモード) を作成します。
DEBUG_DUMP_FULL	完全メモリダンプを作成します (カーネルモードのみ)。

ファイルとユーザーモードミニダンプの書式を指定するには、ファイルに含める情報を使用 WriteDumpFile2 または WriteDumpFileWide します。

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

さらに、カーネルモードデバッグには、次のエイリアスを使用できます。

さらに、次のエイリアスは、ユーザーモードデバッグに使用できます。

別名	価値
DEBUG_USER_WINDOWS_SMALL_DUMP	DEBUG_DUMP_SMALL
DEBUG_USER_WINDOWS_DUMP	DEBUG_DUMP_DEFAULT

カーネルモードのダンプファイルの詳細については、「さまざまな Kernel-Mode ダンプファイルを参照してください。ユーザーモードダンプファイルの詳細については、「さまざまな種類の User-Mode ダンプファイルを参照してください。

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