Fungsi MmMapMdl (wdm.h)

  • Artikel

Fungsi ini memetakan halaman fisik yang dijelaskan oleh daftar deskriptor memori (MDL) ke dalam ruang alamat virtual sistem.

Sintaks

NTSTATUS MmMapMdl(
  [in] PMDL            MemoryDescriptorList,
  [in] ULONG           Protection,
  [in] PMM_MDL_ROUTINE DriverRoutine,
  [in] PVOID           DriverContext
);

Parameter

[in] MemoryDescriptorList

Penunjuk ke MDL yang valid.

[in] Protection

Bitwise bendera yang menunjukkan perlindungan yang akan diatur untuk halaman. Nilai yang mungkin PAGE_Xxx konstanta yang ditentukan dalam Wdm.h.

[in] DriverRoutine

Penunjuk ke rutinitas panggilan balik yang disediakan driver (MM_MDL_ROUTINE) yang dipanggil setelah MDL dipetakan.

[in] DriverContext

Penunjuk ke konteks yang ditentukan driver. Fungsi panggilan balik driver dapat menyimpan informasi status apa pun dalam konteks driver dan kemudian memeriksa nilai, ketika panggilan balik dipanggil.

Nilai kembali

Jika fungsi panggilan balik yang ditujukan oleh DriverRoutine dipanggil, fungsi ini mengembalikan STATUS_SUCCESS. Fungsi mengembalikan nilai NTSTATUS yang sesuai jika MDL tidak dapat dipetakan atau fungsi panggilan balik tidak dapat dipanggil.

Keterangan

MmMapMdl memetakan MDL (jika belum dipetakan), memanggil panggilan balik, lalu merilis pemetaan (jika dibuat). Pemanggil tidak perlu melakukan pembersihan apa pun.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1709
Server minimum yang didukung Server Windows 2016
Target Platform Windows
Header wdm.h
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe (mode kernel)
IRQL <=DISPATCH_LEVEL

Lihat juga

MM_MDL_ROUTINE