Función MapViewOfFile2 (memoryapi.h)
Asigna una vista de un archivo o una sección respaldada por un archivo en el espacio de direcciones del proceso especificado.
Sintaxis
PVOID MapViewOfFile2(
[in] HANDLE FileMappingHandle,
[in] HANDLE ProcessHandle,
[in] ULONG64 Offset,
[in, optional] PVOID BaseAddress,
[in] SIZE_T ViewSize,
[in] ULONG AllocationType,
[in] ULONG PageProtection
);
Parámetros
[in] FileMappingHandle
Identificador a una sección que se va a asignar al espacio de direcciones del proceso especificado.
[in] ProcessHandle
Identificador de un proceso en el que se asignará la sección. El identificador debe tener la máscara de acceso PROCESS_VM_OPERATION .
[in] Offset
Desplazamiento desde el principio de la sección. Debe estar alineado a 64 000.
[in, optional] BaseAddress
Dirección base deseada de la vista. La dirección se redondea hacia abajo hasta el límite de 64 000 más cercano. Si este parámetro es NULL, el sistema elige la dirección base.
[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.
[in] AllocationType
Tipo de asignación. Este parámetro puede ser cero (0) o uno de los siguientes valores constantes:
- MEM_RESERVE : asigna una vista reservada.
- MEM_LARGE_PAGES : asigna una vista de página grande. Esta marca especifica que la vista debe asignarse con 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.
En el caso de 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.
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.
Comentarios
Esta función se implementa como una función insertada en el encabezado y no se puede encontrar en ninguna biblioteca de exportación o DLL. Es lo mismo que llamar a MapViewOfFileNuma2 con el último parámetro establecido en NUMA_NO_PREFERRED_NODE.
Requisitos
| Cliente mínimo compatible | Windows 10, versión 1703 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2016 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | memoryapi.h (incluya Windows.h, Memoryapi.h) |
| Library | onecore.lib |
| Archivo DLL | Kernel32.dll |