MINIDUMP_CALLBACK_OUTPUT 構造体 (minidumpapiset.h)

MiniDumpCallback 関数によって返される情報を格納します。

構文

typedef struct _MINIDUMP_CALLBACK_OUTPUT {
  union {
    ULONG   ModuleWriteFlags;
    ULONG   ThreadWriteFlags;
    ULONG   SecondaryFlags;
    struct {
      ULONG64 MemoryBase;
      ULONG   MemorySize;
    };
    struct {
      BOOL CheckCancel;
      BOOL Cancel;
    };
    HANDLE  Handle;
    struct {
      MINIDUMP_MEMORY_INFO VmRegion;
      BOOL                 Continue;
    };
    struct {
      HRESULT              VmQueryStatus;
      MINIDUMP_MEMORY_INFO VmQueryResult;
    };
    struct {
      HRESULT VmReadStatus;
      ULONG   VmReadBytesCompleted;
    };
    HRESULT Status;
  };
} MINIDUMP_CALLBACK_OUTPUT, *PMINIDUMP_CALLBACK_OUTPUT;

メンバー

ModuleWriteFlags

モジュール書き込み操作フラグ。 このメンバーには、 MODULE_WRITE_FLAGS 列挙の 1 つ以上の値を指定できます。 フラグは、コールバックへのエントリ時に既定値に設定されます。

コールバックの種類が IncludeModuleCallback または ModuleCallback でない限り、このメンバーは無視されます。

ThreadWriteFlags

スレッド書き込み操作フラグ。 このメンバーには、THREAD_WRITE_FLAGS列挙の 1 つ以上の値を指定できます。 フラグは、コールバックへのエントリ時に既定値に設定されます。

コールバックの種類が IncludeThreadCallback、ThreadCallback、または ThreadExCallback でない限り、このメンバーは無視されます。

SecondaryFlags

MINIDUMP_SECONDARY_FLAGS列挙型の値 を 格納します。

DbgHelp 6.5 以前: このメンバーは使用できません。

MemoryBase

ダンプに含めるメモリ領域のベース アドレス。

コールバックの種類が MemoryCallback または RemoveMemoryCallback でない限り、このメンバーは無視されます。

MemorySize

ダンプに含めるメモリ領域のサイズ (バイト単位)。

コールバックの種類が MemoryCallback または RemoveMemoryCallback でない限り、このメンバーは無視されます。

CheckCancel

コールバック関数がキャンセル コールバックを受け取る必要があるかどうかを制御します。 このメンバーが TRUE の場合、キャンセル コールバックは続行されます。 それ以外の場合は、行われません。

コールバックの種類が CancelCallback でない限り、このメンバーは無視されます。

Cancel

ダンプを取り消す必要があるかどうかを制御します。 コールバック関数が TRUE を 返し 、Cancel が TRUE の場合、ダンプは取り消されます。 この場合、 MiniDumpWriteDump 関数は失敗し、ダンプは無効です。

コールバックの種類が CancelCallback でない限り、このメンバーは無視されます。

Handle

カーネル ミニダンプの書き込み先となるファイルのハンドル。

コールバックの種類が WriteKernelMinidumpCallback でない限り、このメンバーは無視されます。

VmRegion

仮想メモリ領域を記述する MINIDUMP_MEMORY_INFO 構造体。 領域のベースとサイズは、ページ境界上に配置する必要があります。 リージョン サイズを 0 に設定して、リージョンを除外できます。

コールバックの種類が IncludeVmRegionCallback でない限り、このメンバーは無視されます。

Continue

ダンプを続行するかどうかを制御します。 コールバック関数が TRUE を 返し、 Continue が TRUE の場合、ダンプは続行されます。 それ以外の場合、 MiniDumpWriteDump 関数は失敗し、ダンプは無効です。

コールバックの種類が IncludeVmRegionCallback でない限り、このメンバーは無視されます。

VmQueryStatus

VmQueryResult

VmReadStatus

VmReadBytesCompleted

Status

操作の状態。

コールバックの種類が ReadMemoryFailureCallback、IoStartCallback、IoWriteAllCallback、または IoFinishCallback でない限り、このメンバーは無視されます。

要件

要件	値
Header	minidumpapiset.h (DbgHelp.h を含む)
再頒布可能パッケージ	DbgHelp.dll 5.1 以降

こちらもご覧ください

MODULE_WRITE_FLAGS

MiniDumpCallback

THREAD_WRITE_FLAGS