Compartilhar via


Função MapViewOfFileNuma2 (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 MapViewOfFileNuma2(
  [in]           HANDLE  FileMappingHandle,
  [in]           HANDLE  ProcessHandle,
  [in]           ULONG64 Offset,
  [in, optional] PVOID   BaseAddress,
  [in]           SIZE_T  ViewSize,
  [in]           ULONG   AllocationType,
  [in]           ULONG   PageProtection,
  [in]           ULONG   PreferredNode
);

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.

[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 uma exibição de página grande

[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.

[in] PreferredNode

O nó NUMA preferido para essa memória.

Retornar valor

Retorna o endereço base do modo de exibição mapeado, se bem-sucedido. Caso contrário, retorna NULL e o erro estendido status está disponível usando GetLastError.

Requisitos

Requisito Valor
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; Onecoreuap.lib
DLL Api-ms-win-core-memory-l1-1-5.dll

Confira também

Mapviewoffile

MapViewOfFileNuma