MmMapMdl, fonction (wdm.h)
Cette fonction mappe les pages physiques décrites par une liste de descripteurs de 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 un MDL valide.
[in] Protection
Niveau de bits des indicateurs 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 MDL.
[in] DriverContext
Pointeur vers un contexte défini par le pilote. La fonction de rappel du pilote peut stocker toutes les informations d’état dans le contexte du pilote, puis examiner la valeur, lorsque le rappel est appelé.
Valeur de retour
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 le MDL (s’il n’est pas déjà mappé), appelle le rappel, puis libère le mappage (s’il en a été créé). L’appelant n’a pas besoin d’effectuer de nettoyage.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10, version 1709 |
| serveur minimum pris en charge | Windows Server 2016 |
| plateforme cible | Windows |
| d’en-tête | wdm.h |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe (mode noyau) |
| IRQL | <=DISPATCH_LEVEL |