Función MmMapLockedPages (wdm.h)

La rutina MmMapLockedPages está obsoleta para Windows 2000 y versiones posteriores de Windows y para Windows Me. Solo se admite para controladores WDM que deben ejecutarse en Windows 98. En caso contrario, use MmMapLockedPagesSpecifyCache.

La rutina MmMapLockedPages asigna las páginas físicas descritas por un MDL determinado.

Sintaxis

PVOID MmMapLockedPages(
  [in] PMDL                                                                          MemoryDescriptorList,
  [in] __drv_strictType(KPROCESSOR_MODE / enum _MODE,__drv_typeConst)KPROCESSOR_MODE AccessMode
);

Parámetros

[in] MemoryDescriptorList

Puntero a una MDL actualizada por MmProbeAndLockPages.

[in] AccessMode

Especifica el modo de acceso en el que se va a asignar MDL, KernelMode o UserMode. Casi todos los controladores deben usar KernelMode.

Valor devuelto

MmMapLockedPages devuelve la dirección inicial de las páginas asignadas. (Para los sistemas operativos basados en NT anteriores a Windows NT 4.0 Service Pack 4 (SP4), MmMapLockedPages devuelve la dirección inicial de la primera página de las páginas asignadas.

Comentarios

Use MmUnmapLockedPages para desasignar las páginas físicas asignadas por MmMapLockedPages.

Si AccessMode es KernelMode y MmMapLockedPages no pueden asignar las páginas especificadas, el sistema emite una comprobación de errores. (Por este motivo, los controladores deben usar MmMapLockedPagesSpecifyCache cuando esté disponible; esa rutina devuelve NULL en caso de error, en lugar de provocar una comprobación de errores). Si AccessMode es UserMode y las páginas especificadas no se pueden asignar, la rutina genera una excepción. Los autores de llamadas que especifican UserMode deben encapsular la llamada a MmMapLockedPages en un bloque try/except . Para obtener más información, consulte Control de excepciones.

Los autores de llamadas de MmMapLockedPages deben ejecutarse en IRQL <= DISPATCH_LEVEL si AccessMode es KernelMode. De lo contrario, el autor de la llamada debe ejecutarse en IRQL <= APC_LEVEL.

Requisitos

Requisito Value
Cliente mínimo compatible Obsoleto para Windows 2000 y versiones posteriores de Windows y para Windows Me. Esta rutina solo se admite para controladores WDM que se deben ejecutar en Windows 98. En caso contrario, use MmMapLockedPagesSpecifyCache.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL vea la sección Comentarios.
Reglas de cumplimiento de DDI HwStorPortProhibitedDDIs(storport)

Consulte también

MmGetSystemAddressForMdl

MmGetSystemAddressForMdlSafe

MmMapLockedPagesSpecifyCache

MmProbeAndLockPages

MmUnmapLockedPages