IDebugClient4::WriteDumpFile 메서드(dbgeng.h)
WriteDumpFile 메서드는 사용자 모드 또는 커널 모드 크래시 덤프 파일을 만듭니다.
통사론
HRESULT WriteDumpFile(
[in] PCSTR DumpFile,
[in] ULONG Qualifier
);
매개 변수
[in] DumpFile
만들 덤프 파일의 이름을 지정합니다. DumpFile 파일 이름 확장명을 포함해야 합니다. DumpFile 상대 또는 절대 경로를 포함할 수 있습니다. 상대 경로는 디버거가 시작된 디렉터리를 기준으로 합니다.
[in] Qualifier
만들 덤프 파일의 형식을 지정합니다. 가능한 값은 비고를 참조하세요.
반환 값
이 메서드는 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값 참조하세요.
반환 코드 | 묘사 |
---|---|
|
메서드가 성공했습니다. |
발언
DEBUG_DUMP_XXX 상수는 WriteDumpFile , WriteDumpFile2및 WriteDumpFileWide메서드에서 사용하여 만들 크래시 덤프 파일의 형식을 지정합니다.
가능한 값은 다음과 같습니다.
상수 | 묘사 |
---|---|
DEBUG_DUMP_SMALL | 작은 메모리 덤프(커널 모드) 또는 미니덤프(사용자 모드)를 만듭니다. |
DEBUG_DUMP_DEFAULT | 전체 User-Mode 덤프(사용자 모드) 또는 커널 요약 덤프(커널 모드)를 만듭니다. |
DEBUG_DUMP_FULL |
전체 메모리 덤프를 만듭니다(커널 모드에만 해당). |
파일의 서식을 지정하고 사용자 모드 미니덤프의 경우 파일에 포함할 정보를 지정하려면 writeDumpFile2 또는 WriteDumpFileWide 사용합니다.
크래시 덤프 파일에 대한 자세한 내용은 Dump-File 대상참조하세요.
또한 커널 모드 디버깅에는 다음 별칭을 사용할 수 있습니다.
별명 | 값 |
---|---|
DEBUG_KERNEL_SMALL_DUMP | DEBUG_DUMP_SMALL |
DEBUG_KERNEL_DUMP | DEBUG_DUMP_DEFAULT |
DEBUG_KERNEL_FULL_DUMP | DEBUG_DUMP_FULL |
또한 다음 별칭은 사용자 모드 디버깅에 사용할 수 있습니다.
별명 | 값 |
---|---|
DEBUG_USER_WINDOWS_SMALL_DUMP | DEBUG_DUMP_SMALL |
DEBUG_USER_WINDOWS_DUMP | DEBUG_DUMP_DEFAULT |
커널 모드 덤프 파일에 대한 설명은 Kernel-Mode 덤프 파일품종을 참조하세요. 사용자 모드 덤프 파일에 대한 설명은 User-Mode 덤프 파일품종을 참조하세요.
요구 사항
요구 | 값 |
---|---|
대상 플랫폼 | 바탕 화면 |
헤더 | dbgeng.h(Dbgeng.h 포함) |