Fonction MmMapMdl (wdm.h)

  • Article

Cette fonction mappe les pages physiques décrites par une liste de descripteurs mémoire (MDL) dans l’espace d’adressage virtuel du système.

Syntaxe

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

Paramètres

[in] MemoryDescriptorList

Pointeur vers une MDL valide.

[in] Protection

Indicateurs au niveau du bit qui indique la protection à définir pour les pages. Les valeurs possibles sont PAGE_Xxx constantes définies dans Wdm.h.

[in] DriverRoutine

Pointeur vers une routine de rappel fournie par le pilote (MM_MDL_ROUTINE) appelée après le mappage de la MDL.

[in] DriverContext

Pointeur vers un contexte défini par le pilote. La fonction de rappel du pilote peut stocker toutes les informations status dans le contexte du pilote, puis examiner la valeur lorsque le rappel est appelé.

Valeur retournée

Si la fonction de rappel pointée par DriverRoutine a été appelée, cette fonction retourne STATUS_SUCCESS. La fonction retourne une valeur NTSTATUS appropriée si le MDL n’a pas pu être mappé ou si la fonction de rappel n’a pas pu être appelée.

Remarques

MmMapMdl mappe la MDL (si elle n’est pas déjà mappée), appelle le rappel, puis libère le mappage (le cas échéant). L’appelant n’a pas besoin d’effectuer de nettoyage.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1709
Serveur minimal pris en charge Windows Server 2016
Plateforme cible Windows
En-tête wdm.h
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe (mode noyau)
IRQL <=DISPATCH_LEVEL

Voir aussi

MM_MDL_ROUTINE