Compartilhar via


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

Confira também

Mapviewoffile

MapViewOfFileNuma2