Fungsi MmMapMdl (wdm.h)

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

Sintaksis

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

Pointer 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 nilainya, ketika panggilan balik dipanggil.

Mengembalikan nilai

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

Komentar

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

Persyaratan

Lihat juga

MM_MDL_ROUTINE