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

Vea también

MapViewOfFile

MapViewOfFileNuma2