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 以降 |