Função MapViewOfFile2 (memoryapi.h)
Mapeia uma exibição de um arquivo ou uma seção com backup de pagefile para o espaço de endereço do processo especificado.
Sintaxe
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
Um HANDLE para uma seção que deve ser mapeada para o espaço de endereço do processo especificado.
[in] ProcessHandle
Um HANDLE para um processo no qual a seção será mapeada. O identificador deve ter a máscara de acesso PROCESS_VM_OPERATION .
[in] Offset
O deslocamento do início da seção. Isso deve estar alinhado a 64k.
[in, optional] BaseAddress
O endereço base desejado da exibição. O endereço é arredondado para baixo até o limite de 64k mais próximo. Se esse parâmetro for NULL, o sistema escolherá o endereço base.
[in] ViewSize
O número de bytes a serem mapeados. Um valor zero (0) especifica que toda a seção deve ser mapeada.
[in] AllocationType
O tipo de alocação. Esse parâmetro pode ser zero (0) ou um dos seguintes valores constantes:
- MEM_RESERVE - Mapeia uma exibição reservada.
- MEM_LARGE_PAGES - Mapeia um modo de exibição de página grande. Esse sinalizador especifica que o modo de exibição deve ser mapeado usando o suporte de página grande. O tamanho do modo de exibição deve ser um múltiplo do tamanho de uma página grande relatada pela função GetLargePageMinimum e o objeto de mapeamento de arquivo deve ter sido criado usando a opção SEC_LARGE_PAGES . Se você fornecer um valor não nulo para o parâmetro BaseAddress , o valor deverá ser um múltiplo de GetLargePageMinimum.
[in] PageProtection
A proteção de página desejada.
Para objetos de mapeamento de arquivo criados com o atributo SEC_IMAGE , o parâmetro PageProtection não tem efeito e deve ser definido como qualquer valor válido, como PAGE_READONLY.
Valor retornado
Retorna o endereço base do modo de exibição mapeado, se bem-sucedido. Caso contrário, retornará NULL e status de erro estendido estará disponível usando GetLastError.
Comentários
Essa função é implementada como uma função embutida no cabeçalho e não pode ser encontrada em nenhuma biblioteca de exportação ou DLL. É o mesmo que chamar MapViewOfFileNuma2 com o último parâmetro definido NUMA_NO_PREFERRED_NODEcomo .
Requisitos
| Cliente mínimo com suporte | Windows 10, versão 1703 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2016 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | memoryapi.h (inclua Windows.h, Memoryapi.h) |
| Biblioteca | onecore.lib |
| DLL | Kernel32.dll |