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 열거형의 값 중 하나 이상일 수 있습니다. 플래그는 콜백 항목에서 기본값으로 설정됩니다.

콜백 유형이 IncludeModuleCallback 또는 ModuleCallback이 아니면 이 멤버는 무시됩니다.

ThreadWriteFlags

스레드 쓰기 작업 플래그입니다. 이 멤버는 THREAD_WRITE_FLAGS 열거형의 값 중 하나 이상일 수 있습니다. 플래그는 콜백 항목에서 기본값으로 설정됩니다.

콜백 유형이 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이 아니면 이 멤버는 무시됩니다.

요구 사항

요구 사항	값
헤더	minidumpapiset.h(DbgHelp.h 포함)
재배포 가능 파일	DbgHelp.dll 5.1 이상

추가 정보

MODULE_WRITE_FLAGS

MiniDumpCallback

THREAD_WRITE_FLAGS