Función MmMapMdl (wdm.h)

  • Artículo

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

Marca bit a bit 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 (MM_MDL_ROUTINE) proporcionada por el controlador 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 mdl o no se pudo invocar la función de devolución de llamada.

Comentarios

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 ha creado). El autor de la llamada no necesita realizar ninguna limpieza.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1709
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Encabezado wdm.h
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe (modo kernel)
IRQL <=DISPATCH_LEVEL

Consulte también

MM_MDL_ROUTINE