Función MapViewOfFile3 (memoryapi.h)

Artículo
06/27/2024

Asigna una vista de un archivo o una sección respaldada por pagefile en el espacio de direcciones del proceso especificado.

Sintaxis

PVOID MapViewOfFile3(
  [in]                HANDLE                 FileMapping,
  [in]                HANDLE                 Process,
  [in, optional]      PVOID                  BaseAddress,
  [in]                ULONG64                Offset,
  [in]                SIZE_T                 ViewSize,
  [in]                ULONG                  AllocationType,
  [in]                ULONG                  PageProtection,
  [in, out, optional] MEM_EXTENDED_PARAMETER *ExtendedParameters,
  [in]                ULONG                  ParameterCount
);

Parámetros

[in] FileMapping

Un HANDLE a una sección que se va a asignar al espacio de direcciones del proceso especificado.

[in] Process

Un HANDLE a un proceso en el que se asignará la sección.

[in, optional] BaseAddress

Dirección base deseada de la vista (la dirección se redondea hacia abajo hasta el límite de 64 k más cercano).

Si este parámetro es NULL, el sistema elige la dirección base.

Si BaseAddress no es NULL, los MEM_ADDRESS_REQUIREMENTS proporcionados deben constar de todos los ceros.

[in] Offset

Desplazamiento desde el principio de la sección.

El desplazamiento debe estar alineado con 64 000.

[in] ViewSize

Número de bytes que se van a asignar. Un valor de cero (0) especifica que se va a asignar toda la sección.

El tamaño siempre debe ser un múltiplo del tamaño de página.

[in] AllocationType

Tipo de asignación de memoria. Este parámetro puede ser cero (0) o uno de los valores siguientes.

Valor	Significado
MEM_RESERVE 0x00002000	Asigna una vista reservada.
MEM_REPLACE_PLACEHOLDER 0x00004000	Reemplaza un marcador de posición por una vista asignada. Solo se admiten vistas de sección con respaldo de datos o pf (sin imágenes, memoria física, etc.). Al reemplazar un marcador de posición, BaseAddress y ViewSize deben coincidir exactamente con los del marcador de posición y cualquier estructura de MEM_ADDRESS_REQUIREMENTS proporcionada debe constar de todos los ceros. Después de reemplazar un marcador de posición por una vista asignada, para liberar esa vista asignada a un marcador de posición, vea el parámetro UnmapFlags de UnmapViewOfFileEx y UnmapViewOfFile2. Un marcador de posición es un tipo de región de memoria reservada. Los requisitos de alineación de 64 000 en de desplazamiento y BaseAddress no se aplican cuando se especifica esta marca.
MEM_LARGE_PAGES 0x20000000	Asigna una vista de página grande. Esta marca especifica que la vista se debe asignar mediante compatibilidad con páginas grandes. El tamaño de la vista debe ser un múltiplo del tamaño de una página grande notificada por la función GetLargePageMinimum y el objeto de asignación de archivos debe haberse creado con la opción SEC_LARGE_PAGES. Si proporciona un valor distinto de null para el parámetro BaseAddress, el valor debe ser un múltiplo de GetLargePageMinimum.

Valor

Significado

MEM_RESERVE
0x00002000

Asigna una vista reservada.

MEM_REPLACE_PLACEHOLDER
0x00004000

Reemplaza un marcador de posición por una vista asignada. Solo se admiten vistas de sección con respaldo de datos o pf (sin imágenes, memoria física, etc.). Al reemplazar un marcador de posición, BaseAddress y ViewSize deben coincidir exactamente con los del marcador de posición y cualquier estructura de MEM_ADDRESS_REQUIREMENTS proporcionada debe constar de todos los ceros.

Después de reemplazar un marcador de posición por una vista asignada, para liberar esa vista asignada a un marcador de posición, vea el parámetro UnmapFlags de UnmapViewOfFileEx y UnmapViewOfFile2.

Un marcador de posición es un tipo de región de memoria reservada.

Los requisitos de alineación de 64 000 en de desplazamiento y BaseAddress no se aplican cuando se especifica esta marca.

MEM_LARGE_PAGES
0x20000000

Asigna una vista de página grande. Esta marca especifica que la vista se debe asignar mediante compatibilidad con páginas grandes. El tamaño de la vista debe ser un múltiplo del tamaño de una página grande notificada por la función GetLargePageMinimum y el objeto de asignación de archivos debe haberse creado con la opción SEC_LARGE_PAGES. Si proporciona un valor distinto de null para el parámetro BaseAddress, el valor debe ser un múltiplo de GetLargePageMinimum.

[in] PageProtection

Protección de página deseada.

Para los objetos de asignación de archivos creados con el atributo SEC_IMAGE, el parámetro PageProtection no tiene ningún efecto y debe establecerse en cualquier valor válido, como PAGE_READONLY.

[in, out, optional] ExtendedParameters

Puntero opcional a uno o varios parámetros extendidos de tipo MEM_EXTENDED_PARAMETER. Cada uno de esos valores de parámetro extendidos puede tener un campo Type de MemExtendedParameterAddressRequirements o MemExtendedParameterNumaNode. Si no se proporciona ningún parámetro extendido MemExtendedParameterNumaNode, el comportamiento es el mismo que para las funciones VirtualAlloc/MapViewOfFile (es decir, el nodo NUMA preferido para las páginas físicas se determina en función del procesador ideal del subproceso que accede primero a la memoria).

[in] ParameterCount

Número de parámetros extendidos a los que apunta ExtendedParameters.

Valor devuelto

Devuelve la dirección base de la vista asignada, si se ejecuta correctamente. De lo contrario, devuelve NULL y el estado de error extendido está disponible mediante GetLastError.

Observaciones

Esta API ayuda a admitir juegos de alto rendimiento y aplicaciones de servidor, que tienen requisitos específicos para administrar su espacio de direcciones virtual. Por ejemplo, asignar memoria encima de una región reservada anteriormente; esto resulta útil para implementar un búfer de anillo de ajuste automático. Y asignar memoria con alineación específica; por ejemplo, para permitir que la aplicación confirme regiones asignadas a páginas grandes o enormes a petición.

Con esta función para las nuevas asignaciones, puede hacer lo siguiente:

especificar un intervalo de espacio de direcciones virtuales y una restricción de alineación de potencia de 2
especificar un número arbitrario de parámetros extendidos
especificar un nodo NUMA preferido para la memoria física como parámetro extendido
especifique una operación de marcador de posición (específicamente, reemplazo).

Para especificar el nodo NUMA, consulte el parámetro ExtendedParameters.

Ejemplos

Para obtener un ejemplo de código, vea Escenario 1 en VirtualAlloc2.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10, versión 1803 [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2016 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	memoryapi.h (incluya Windows.h)
biblioteca de	onecore.lib
DLL de	Kernel32.dll

Consulte también

VirtualAlloc2

MapViewOfFile

MapViewOfFile2

MapViewOfFileNuma2

Compartir a través de