DUMP_WRITE fungsi panggilan balik (ntdddump.h)
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) |