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

Consulte también

MM_MDL_ROUTINE