Función MmMapIoSpace (wdm.h)

La rutina MmMapIoSpace asigna el intervalo de direcciones físicos especificado al espacio del sistema no paginado.

Sintaxis

PVOID MmMapIoSpace(
  [in] PHYSICAL_ADDRESS    PhysicalAddress,
  [in] SIZE_T              NumberOfBytes,
  [in] MEMORY_CACHING_TYPE CacheType
);

Parámetros

[in] PhysicalAddress

Especifica la dirección física inicial del intervalo de E/S que se va a asignar.

[in] NumberOfBytes

Especifica un valor mayor que cero, que indica el número de bytes que se van a asignar.

[in] CacheType

Especifica un valor de MEMORY_CACHING_TYPE, que indica el atributo de caché que se va a usar para asignar el intervalo de direcciones físico.

Valor devuelto

MmMapIoSpace devuelve la dirección virtual base que asigna la dirección física base para el intervalo. Si el espacio para asignar el intervalo no es suficiente, devuelve NULL.

Observaciones

Un controlador debe llamar a esta rutina durante el inicio del dispositivo si recibe recursos traducidos de tipo CmResourceTypeMemory en una estructura de CM_PARTIAL_RESOURCE_DESCRIPTOR. MmMapIoSpace asigna la dirección física devuelta en la lista de recursos a una dirección lógica a través de la cual el controlador puede acceder a los registros de dispositivos.

MmMapIoSpace solo debe usarse con páginas bloqueadas (pertenecen a las páginas bloqueadas de un espacio de E/S o MDL), de lo contrario, el propietario de la memoria podría liberarla (o la memoria podría paginarse dentro y fuera, etc.).

Por ejemplo, los controladores de dispositivos PIO que asignan búferes de E/S a largo plazo pueden llamar a esta rutina para que dichos búferes sean accesibles o para que la memoria del dispositivo sea accesible.

Para obtener más información sobre el uso de esta rutina, vea Asignación de direcciones Bus-Relative a direcciones virtuales.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	IRQL <=DISPATCH_LEVEL

Consulte también

mmAllocateContiguousMemory

MmAllocateNonCachedMemory

MmMapLockedPages

MmUnmapIoSpace