Função AllocateUserPhysicalPages2 (memoryapi.h)

Artigo
12/14/2023

Aloca páginas de memória física a serem mapeadas e não mapeadas em qualquer região do AWE (Address Windowing Extensions) de um processo especificado, com parâmetros estendidos.

Sintaxe

BOOL AllocateUserPhysicalPages2(
  [in]     HANDLE                  ObjectHandle,
  [in,out] PULONG_PTR              NumberOfPages,
  [out]    PULONG_PTR              PageArray,
  [in,out] PMEM_EXTENDED_PARAMETER ExtendedParameters,
  [in]     ULONG                   ExtendedParameterCount
);

Parâmetros

[in] ObjectHandle

Um identificador para um processo.

A função aloca memória que pode ser mapeada posteriormente dentro do espaço de endereço virtual desse processo. O identificador deve ter o direito de acesso PROCESS_VM_OPERATION . Para obter mais informações, consulte Direitos de acesso e segurança do processo.

[in,out] NumberOfPages

O tamanho da memória física a ser alocada, em páginas.

Para determinar o tamanho da página do computador, use a função GetSystemInfo . Na saída, esse parâmetro recebe o número de páginas realmente alocadas, o que pode ser menor do que o número solicitado.

[out] PageArray

Um ponteiro para uma matriz para armazenar os números de quadro de página da memória alocada.

O tamanho da matriz alocada deve ser pelo menos o NumberOfPages vezes o tamanho do tipo de dados ULONG_PTR .

Não tente modificar esse buffer. Ele contém dados do sistema operacional e a corrupção pode ser catastrófica. As informações no buffer não são úteis para um aplicativo.

[in,out] ExtendedParameters

Ponteiro para uma matriz de estruturas MEM_EXTENDED_PARAMETER .

[in] ExtendedParameterCount

O número de MEM_EXTENDED_PARAMETER na matriz ExtendedParameters .

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE.

Menos páginas do que as solicitadas podem ser alocadas. O chamador deve marcar o valor do parâmetro NumberOfPages no retorno para ver quantas páginas são alocadas. Todos os números de quadro de página alocados são colocados sequencialmente na memória apontada pelo parâmetro UserPfnArray .

Se a função falhar, o valor retornado será FALSE e nenhum quadro será alocado. Para obter informações de erro estendidas, chame GetLastError.

Comentários

AllocateUserPhysicalPages2 é o mesmo que AllocateUserPhysicalPages , mas adiciona os parâmetros ExtendedParameters e ExtendedParameterCount .

A função AllocateUserPhysicalPages2 é usada para alocar memória física que posteriormente pode ser mapeada dentro do espaço de endereço virtual do processo. O privilégio SeLockMemoryPrivilege deve ser habilitado no token do chamador ou a função falhará com ERROR_PRIVILEGE_NOT_HELD. Para obter mais informações, consulte Constantes de privilégio.

A memória alocada por essa função deve estar fisicamente presente no sistema. Depois que a memória é alocada, ela é bloqueada e indisponível para o restante do sistema de gerenciamento de memória virtual.

As páginas físicas não podem ser mapeadas simultaneamente em mais de um endereço virtual.

As páginas físicas podem residir em qualquer endereço físico. Você não deve fazer suposições sobre a contígua das páginas físicas.

Requisitos


Cliente mínimo com suporte	Windows 11, Build 20348
Servidor mínimo com suporte	Windows Server, Build 20348
Cabeçalho	memoryapi.h
Biblioteca	onecore.lib
DLL	kernelbase.dll