Fungsi FsRtlMdlReadDev (ntifs.h)
Rutinitas FsRtlMdlReadDev mengembalikan daftar deskriptor memori (MDL) yang menunjuk langsung ke rentang byte yang ditentukan dalam cache file.
Sintaks
BOOLEAN FsRtlMdlReadDev(
[in] PFILE_OBJECT FileObject,
[in] PLARGE_INTEGER FileOffset,
[in] ULONG Length,
[in] ULONG LockKey,
[out] PMDL *MdlChain,
[out] PIO_STATUS_BLOCK IoStatus,
[ in, optional ] PDEVICE_OBJECT DeviceObject
);
Parameter
[in] FileObject
Penunjuk ke objek file untuk file yang di-cache.
[in] FileOffset
Penunjuk ke variabel yang menentukan offset byte awal dalam file cache yang menyimpan data.
[in] Length
Panjang byte data yang akan dibaca dari cache.
[in] LockKey
Nilai yang terkait dengan rentang byte untuk dikunci. Jika rentang untuk mengunci tumpang tindih dengan rentang lain yang sudah dikunci dengan kunci tidak termasuk, atau jika rentang yang akan dibaca adalah subrange dari rentang lain yang sudah dikunci secara non-eksklusif, nilai dalam parameter ini harus menjadi kunci untuk kunci yang tidak termasuk Kunci harus dipegang oleh proses induk utas panggilan. Jika tidak, parameter ini tidak berpengaruh.
[out] MdlChain
Pada output, penunjuk ke daftar daftar deskriptor memori (MDL) yang ditautkan.
[out] IoStatus
Penunjuk ke struktur IO_STATUS_BLOCK yang, pada output, berisi status transfer. Jika operasi berhasil, IoStatus.Status diatur ke STATUS_SUCCESS. Jika tidak, ini diatur ke kode kesalahan NTSTATUS yang sesuai. IoStatus.Information diatur ke jumlah byte aktual yang berhasil dikunci rutinitas.
[ in, optional ] DeviceObject
Penunjuk ke objek perangkat tempat file dibuka.
Nilai kembali
Rutinitas FsRtlMdlReadDev mengembalikan TRUE jika operasi berhasil dan FALSE jika operasi gagal.
Keterangan
FsRtlMdlReadDev rutin melewati mekanisme IRP yang biasa dan mengembalikan daftar tertaut daftar deskriptor memori (MDL) yang dapat digunakan pemanggil untuk langsung mengakses data file yang di-cache. Operasi ini tidak menyalin atau menyangga data dan oleh karena itu jauh lebih cepat daripada bacaan normal.
Rutinitasnya mirip dengan CcMdlRead dan FltFastIoMdlRead. FltFastIoMdlRead, CcMdlRead, dan FsRtlMdlReadDev mengunci halaman yang berisi data file yang di-cache untuk mencegah sistem menukar halaman ini ke file halaman. Halaman tetap terkunci dalam memori sampai pemanggil memanggil rutinitas FsRtlMdlReadCompleteDev .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Header | ntifs.h (termasuk Ntifs.h) |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |