IDebugClient2::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 Targets」を参照してください。

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

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

エイリアス	値
DEBUG_USER_WINDOWS_SMALL_DUMP	DEBUG_DUMP_SMALL
DEBUG_USER_WINDOWS_DUMP	DEBUG_DUMP_DEFAULT

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

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