MINIDUMP_CALLBACK_TYPE 열거형(minidumpapiset.h)
MiniDumpCallback 함수에서 반환되는 정보의 유형을 식별합니다. 모든 메모리 오류로 인해 콜백이 발생하는 것은 아닙니다. 예를 들어 오류가 스택 내에 있는 경우 오류는 복구할 수 없는 것으로 간주되고 미니덤프는 실패합니다.
Syntax
typedef enum _MINIDUMP_CALLBACK_TYPE {
ModuleCallback,
ThreadCallback,
ThreadExCallback,
IncludeThreadCallback,
IncludeModuleCallback,
MemoryCallback,
CancelCallback,
WriteKernelMinidumpCallback,
KernelMinidumpStatusCallback,
RemoveMemoryCallback,
IncludeVmRegionCallback,
IoStartCallback,
IoWriteAllCallback,
IoFinishCallback,
ReadMemoryFailureCallback,
SecondaryFlagsCallback,
IsProcessSnapshotCallback,
VmStartCallback,
VmQueryCallback,
VmPreReadCallback,
VmPostReadCallback
} MINIDUMP_CALLBACK_TYPE;
상수
ModuleCallback콜백 함수는 모듈 정보를 반환합니다. |
ThreadCallback콜백 함수는 스레드 정보를 반환합니다. |
ThreadExCallback콜백 함수는 확장 스레드 정보를 반환합니다. |
IncludeThreadCallback콜백 함수는 포함할 스레드를 나타냅니다. 미니덤프 라이브러리로 호출됩니다. 정보를 수집한 후가 아니라 프로세스에서 스레드를 열거합니다. ThreadCallback 또는 ThreadExCallback. 에 대해 호출됩니다. 각 스레드. 콜백 함수가 FALSE를 반환하면 현재 스레드가 제외됩니다. 이렇게 하면 호출자가 일시 중단 없이 프로세스에서 스레드의 하위 집합에 대한 정보를 가져올 수 있습니다. 관심 없는 스레드입니다. 또는 ThreadWriteFlags를 수정할 수 있습니다. MINIDUMP_CALLBACK_OUTPUT 멤버 구조화 및 반환 TRUE 에 대 한 불필요 한 정보를 수집 하지 않도록 스레드. |
IncludeModuleCallback콜백 함수는 포함할 모듈을 나타냅니다. 콜백 함수는 다음으로 호출됩니다. 미니덤프 라이브러리는 정보를 수집한 후가 아니라 프로세스에서 모듈을 열거합니다. 은 ModuleCallback과 함께 있습니다. 각 모듈에 대해 호출됩니다. 콜백 함수인 경우 는 FALSE를 반환하고 현재 모듈은 제외됩니다. 또는 다음을 수정할 수 있습니다. ModuleWriteFlags 멤버 MINIDUMP_CALLBACK_OUTPUT 구조 및 모듈에 대한 불필요한 정보를 수집하지 않도록 TRUE 를 반환합니다. |
MemoryCallback콜백 함수는 덤프에 포함할 메모리 영역을 반환합니다. 콜백만 호출됩니다. MiniDumpWithFullMemory 플래그 없이 생성된 덤프의 경우 입니다. 콜백 함수가 반환하는 경우 FALSE 또는 크기가 0인 지역은 콜백이 다시 호출되지 않습니다. DbgHelp 6.1 이하: 이 값은 지원되지 않습니다. |
CancelCallback콜백 함수는 취소 정보를 반환합니다. DbgHelp 6.1 이하: 이 값은 지원되지 않습니다. |
WriteKernelMinidumpCallback사용자 모드 미니덤프가 성공적으로 완료되었습니다. 커널 모드 미니덤프를 시작하려면 콜백 는 TRUE를 반환하고 의 Handle 멤버를 설정해야 합니다. MINIDUMP_CALLBACK_OUTPUT 구조체입니다. DbgHelp 6.1 이하: 이 값은 지원되지 않습니다. |
KernelMinidumpStatusCallback콜백 함수는 커널 미니덤프에 대한 상태 정보를 반환합니다. DbgHelp 6.1 이하: 이 값은 지원되지 않습니다. |
RemoveMemoryCallback콜백 함수는 덤프에서 제외할 메모리 영역을 반환합니다. 콜백만 호출됩니다. MiniDumpWithFullMemory 플래그 없이 생성된 덤프의 경우 입니다. 콜백인 경우 함수는 FALSE 를 반환하거나 크기가 0인 지역을 반환합니다. 콜백은 다시 호출되지 않습니다. DbgHelp 6.3 이하: 이 값은 지원되지 않습니다. |
IncludeVmRegionCallback콜백 함수는 가상 메모리 영역에 대한 정보를 반환합니다. 각각에 대해 두 번 호출됩니다. 전체 메모리 쓰기 단계 중 지역입니다. 의 VmRegion 멤버입니다. MINIDUMP_CALLBACK_OUTPUT 구조체 에는 현재 메모리 영역이 포함되어 있습니다. 새 경우 지역의 기본 주소와 크기를 수정할 수 있습니다. 지역은 원래 지역의 하위 집합으로 유지됩니다. 다른 멤버에 대한 변경 내용은 무시됩니다. 콜백이 반환되면 TRUE 이고 다음의 Continue 멤버를 설정합니다. MINIDUMP_CALLBACK_OUTPUT TRUE, 미니덤프 라이브러리는 에 지정된 지역을 사용합니다. VmRegion 을 작성할 영역으로 지정합니다. 콜백이 반환되면 FALSE 이거나 Continue 가 FALSE이면 추가 메모리 영역에 대해 콜백이 호출되지 않습니다. DbgHelp 6.4 이하: 이 값은 지원되지 않습니다. |
IoStartCallback콜백 함수는 호출자가 대체 I/O 루틴을 제공할 것임을 나타냅니다. 콜백인 경우 는 TRUE를 반환하고 의 상태 멤버를 설정합니다. MINIDUMP_CALLBACK_OUTPUT S_FALSE 미니덤프 라이브러리는 콜백을 통해 모든 I/O를 보냅니다. 호출자는 각 데이터 조각에 대해 IoWriteAllCallback 콜백 을 수신합니다. DbgHelp 6.4 이하: 이 값은 지원되지 않습니다. |
IoWriteAllCallback콜백은 요청된 모든 바이트를 작성하거나 실패해야 합니다. 의 Io 멤버 MINIDUMP_CALLBACK_INPUT 구조체 포함 요청입니다. 쓰기 작업이 실패하면 콜백은 FALSE를 반환해야 합니다. 여기서 쓰기 작업이 성공하면 콜백은 TRUE 를 반환하고 를 설정해야 합니다. 의 상태 멤버 MINIDUMP_CALLBACK_OUTPUT S_OK. 호출자는 IoFinishCallback 콜백 을 받습니다. I/O가 완료되면 입니다. DbgHelp 6.4 이하: 이 값은 지원되지 않습니다. |
IoFinishCallback콜백은 I/O 완료 정보를 반환합니다. 콜백이 FALSE 또는 를 반환하는 경우 가 의 상태 멤버를 설정하지 않음 MINIDUMP_CALLBACK_OUTPUT S_OK 미니덤프 라이브러리는 미니덤프 쓰기 작업이 실패했다고 가정합니다. DbgHelp 6.4 이하: 이 값은 지원되지 않습니다. |
ReadMemoryFailureCallback메모리를 읽지 못했습니다. 콜백이 TRUE 를 반환하고 를 설정하는 경우 의 상태 멤버 MINIDUMP_CALLBACK_OUTPUT S_OK 메모리 오류가 무시되고 블록이 미니덤프에서 생략됩니다. 그렇지 않으면 실패하면 미니덤프에 쓸 수 없습니다. DbgHelp 6.4 이하: 이 값은 지원되지 않습니다. |
SecondaryFlagsCallback콜백은 보조 정보를 반환합니다. DbgHelp 6.5 이하: 이 값은 지원되지 않습니다. |
IsProcessSnapshotCallback콜백 함수는 대상이 프로세스인지 스냅샷 여부를 나타냅니다. DbgHelp 6.2 이하: 이 값은 지원되지 않습니다. |
VmStartCallback콜백 함수는 호출 수신자가 VmQueryCallback, VmPreReadCallback 및 VmPostReadCallback과 같은 가상 메모리 콜백을 지원하고 수락하는지 여부를 나타냅니다. S_FALSE 반환 값은 가상 메모리 콜백이 지원됨을 의미합니다. S_OK 값은 가상 메모리 콜백이 지원되지 않음을 의미합니다. DbgHelp 6.2 이하: 이 값은 지원되지 않습니다. |
VmQueryCallback콜백 함수는 대상에서 가상 주소 메모리 정보를 수집하기 위해 스냅샷 대상에 대해 호출됩니다. 콜백은 VmStartCallback 이 S_FALSE 값을 반환한 경우에만 호출됩니다. DbgHelp 6.2 이하: 이 값은 지원되지 않습니다. |
VmPreReadCallback콜백 함수는 모든 ReadVirtual 작업에 대해 전송됩니다. 이러한 읽기는 덤프에 추가되는 메모리 블록으로 제한되지 않습니다. 또한 엔진은 PEB(프로세스 환경 블록), TEB(스레드 환경 블록), 로더 데이터, 언로드된 모듈 추적 및 기타 블록에 액세스합니다. 이러한 블록이 덤프에서 끝나지 않더라도 대상에서 읽혀지고 각각에 대해 가상 메모리 콜백이 시작됩니다. 콜백은 VmStartCallback 이 S_FALSE 반환한 경우에만 호출됩니다. DbgHelp 6.2 이하: 이 값은 지원되지 않습니다. |
VmPostReadCallback콜백 함수를 사용하면 호출 수신자가 캐시와 같은 다른 원본의 데이터로 버퍼 콘텐츠를 변경하거나 난독 처리를 수행할 수 있습니다. 이 시점에서 버퍼는 VmPreReadCallback 및 ReadProcessMemory에 의해 완전히 또는 부분적으로 채워집니다. 콜백은 VmStartCallback 이 S_FALSE 반환한 경우에만 호출됩니다. DbgHelp 6.2 이하: 이 값은 지원되지 않습니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | minidumpapiset.h(DbgHelp.h 포함) |
| 재배포 가능 파일 | DbgHelp.dll 5.1 이상 |