Compartir a través de


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

Consulte también

MM_MDL_ROUTINE