Metode IDebugClient2::WriteDumpFile (dbgeng.h)

Artikel
02/23/2024

Metode WriteDumpFile membuat mode pengguna atau file cadangan kernel-modecrash.

Sintaks

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

Parameter

[in] DumpFile

Menentukan nama file cadangan yang akan dibuat. DumpFile harus menyertakan ekstensi nama file. DumpFile dapat mencakup jalur relatif atau absolut; jalur relatif relatif terhadap direktori tempat debugger dimulai.

[in] Qualifier

Menentukan tipe file cadangan yang akan dibuat. Untuk nilai yang mungkin, lihat Keterangan.

Nilai kembali

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Konstanta DEBUG_DUMP_XXXX digunakan oleh metode WriteDumpFile, WriteDumpFile2, dan WriteDumpFileWide untuk menentukan jenis file crash dump yang akan dibuat.

Nilai yang mungkin mencakup yang berikut ini.

Terus-menerus	Deskripsi
DEBUG_DUMP_SMALL	Membuat Small Memory Dump (kernel-mode) atau Minidump (user-mode).
DEBUG_DUMP_DEFAULT	Membuat Full User-Mode Dump (user-mode) atau Kernel Summary Dump (kernel-mode).
DEBUG_DUMP_FULL	Membuat Dump Memori Lengkap (hanya mode kernel).

Untuk menentukan pemformatan file dan--untuk minidumps mode pengguna--informasi yang akan disertakan dalam file, gunakan WriteDumpFile2 atau WriteDumpFileWide.

Untuk informasi selengkapnya tentang file crash dump, lihat Target File Cadangan.

Selain itu, alias berikut tersedia untuk debugging mode kernel.

Alias	Nilai
DEBUG_KERNEL_SMALL_DUMP	DEBUG_DUMP_SMALL
DEBUG_KERNEL_DUMP	DEBUG_DUMP_DEFAULT
DEBUG_KERNEL_FULL_DUMP	DEBUG_DUMP_FULL

Selain itu, alias berikut tersedia untuk penelusuran kesalahan mode pengguna.

Alias	Nilai
DEBUG_USER_WINDOWS_SMALL_DUMP	DEBUG_DUMP_SMALL
DEBUG_USER_WINDOWS_DUMP	DEBUG_DUMP_DEFAULT

Untuk deskripsi file cadangan mode kernel, lihat Varietas file cadangan Kernel-Mode. Untuk deskripsi file cadangan mode pengguna, lihat Varietas file cadangan User-Mode.