다음을 통해 공유


IDebugClient4::WriteDumpFile 메서드(dbgeng.h)

WriteDumpFile 메서드는 사용자 모드 또는 커널 모드 크래시 덤프 파일을 만듭니다.

통사론

HRESULT WriteDumpFile(
  [in] PCSTR DumpFile,
  [in] ULONG Qualifier
);

매개 변수

[in] DumpFile

만들 덤프 파일의 이름을 지정합니다. DumpFile 파일 이름 확장명을 포함해야 합니다. DumpFile 상대 또는 절대 경로를 포함할 수 있습니다. 상대 경로는 디버거가 시작된 디렉터리를 기준으로 합니다.

[in] Qualifier

만들 덤프 파일의 형식을 지정합니다. 가능한 값은 비고를 참조하세요.

반환 값

이 메서드는 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값 참조하세요.

반환 코드 묘사
S_OK
메서드가 성공했습니다.

발언

DEBUG_DUMP_XXX 상수는 WriteDumpFile , WriteDumpFile2WriteDumpFileWide메서드에서 사용하여 만들 크래시 덤프 파일의 형식을 지정합니다.

가능한 값은 다음과 같습니다.

상수 묘사
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 포함)

참고 항목

.dump(덤프 파일 만들기)

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

WriteDumpFile2

WriteDumpFileWide