DUMP_WRITE fungsi panggilan balik (ntdddump.h)

  • Artikel

Rutinitas panggilan balik Dump_Write dipanggil sebelum menulis ke driver port cadangan. Driver filter dapat mengakses data cadangan saat ini.

Sintaks

DUMP_WRITE DumpWrite;

NTSTATUS DumpWrite(
  [in]      PFILTER_EXTENSION FilterExtension,
  [in, out] PLARGE_INTEGER DiskByteOffset,
  [in, out] PMDL Mdl
)
{...}

Parameter

[in] FilterExtension

Penunjuk ke struktur FILTER_EXTENSION .

[in, out] DiskByteOffset

Nilai, dalam byte, relatif terhadap partisi tujuan untuk crash dump atau hibernasi. Driver filter tidak boleh mengubah bidang ini.

[in, out] Mdl

Penunjuk ke struktur MDL yang menjelaskan buffer data. Jika MDL dimodifikasi, ukuran operasi tulis tidak dapat berubah.

Nilai kembali

Jika rutinitas berhasil, rutinitas harus mengembalikan STATUS_SUCCESS. Jika tidak, itu harus mengembalikan salah satu nilai status kesalahan yang ditentukan dalam Ntstatus.h.

Keterangan

Driver filter dapat membaca data yang perlu ditulis. Namun, driver filter tidak dapat menulis ke buffer, karena ini dapat mengubah konten kode atau data yang sedang digunakan oleh proses crash dump. Selain itu, driver filter tidak diizinkan untuk mengubah ukuran data.

Untuk memodifikasi data untuk tulis cadangan dengan aman, driver filter harus mengalokasikan buffer sekunder. Ukuran buffer akan menjadi nilai anggota MaxPagesPerWritedari FILTER_INITIALIZATION_DATA dikalikan dengan PAGE_SIZE. Data untuk buffer saat ini yang dijelaskan oleh Mdl disalin ke dalam buffer sekunder dan diproses. Setelah filter selesai menangani data cadangan di buffer sekunder, MDL yang diarahkan oleh Mdl diperbarui dengan alamat buffer sekunder. Alamat awal buffer sekunder yang diatur dalam MDL harus diratakan halaman.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows Vista dan Windows Server 2008.
Target Platform Desktop
Header ntdddump.h (termasuk Ntdddump.h)

Lihat juga

Dump_Read

FILTER_EXTENSION

FILTER_INITIALIZATION_DATA