Función MmMapMdl (wdm.h)
Esta función asigna páginas físicas descritas por una lista de descriptores de memoria (MDL) al espacio de direcciones virtuales del sistema.
Sintaxis
NTSTATUS MmMapMdl(
[in] PMDL MemoryDescriptorList,
[in] ULONG Protection,
[in] PMM_MDL_ROUTINE DriverRoutine,
[in] PVOID DriverContext
);
Parámetros
[in] MemoryDescriptorList
Puntero a un MDL válido.
[in] Protection
Un bit a bit de marcas que indica la protección que se va a establecer para las páginas. Los valores posibles son PAGE_Xxx constantes definidas en Wdm.h.
[in] DriverRoutine
Puntero a una rutina de devolución de llamada proporcionada por el controlador (MM_MDL_ROUTINE) que se invoca después de asignar la MDL.
[in] DriverContext
Puntero a un contexto definido por el controlador. La función de devolución de llamada del controlador puede almacenar cualquier información de estado en el contexto del controlador y, a continuación, examinar el valor, cuando se invoca la devolución de llamada.
Valor devuelto
Si se invocó la función de devolución de llamada a la que apunta driverRoutine, esta función devuelve STATUS_SUCCESS. La función devuelve un valor NTSTATUS adecuado si no se pudo asignar la MDL o no se pudo invocar la función de devolución de llamada.
Observaciones
MmMapMdl asigna MDL (si aún no está asignado), invoca la devolución de llamada y, a continuación, libera la asignación (si se creó). El autor de la llamada no necesita realizar ninguna limpieza.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 1709 |
| servidor mínimo admitido | Windows Server 2016 |
| de la plataforma de destino de | Windows |
| encabezado de | wdm.h |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe (modo kernel) |
| irQL | <=DISPATCH_LEVEL |