Função VirtualAlloc2FromApp (memoryapi.h)
Reserva, confirma ou altera o estado de uma região de páginas no espaço de endereço virtual do processo de chamada. A memória alocada por essa função é inicializada automaticamente como zero.
Usando essa função, você pode: para novas alocações, especificar um intervalo de espaço de endereço virtual e uma restrição de alinhamento de potência de 2; especificar um número arbitrário de parâmetros estendidos; especificar um nó NUMA preferencial para a memória física como um parâmetro estendido; e especifique uma operação de espaço reservado (especificamente, substituição).
Para especificar o nó NUMA, consulte o parâmetro ExtendedParameters.
Sintaxe
PVOID VirtualAlloc2FromApp(
[in, optional] HANDLE Process,
[in, optional] PVOID BaseAddress,
[in] SIZE_T Size,
[in] ULONG AllocationType,
[in] ULONG PageProtection,
[in, out, optional] MEM_EXTENDED_PARAMETER *ExtendedParameters,
[in] ULONG ParameterCount
);
Parâmetros
[in, optional] Process
O identificador de um processo. A função aloca memória dentro do espaço de endereço virtual desse processo.
O identificador deve ter o acesso PROCESS_VM_OPERATION correto. Para obter mais informações, consulte Process Security and Access Rights.
[in, optional] BaseAddress
O ponteiro que especifica um endereço inicial desejado para a região das páginas que você deseja alocar.
Se BaseAddress for NULL, a função determinará onde alocar a região.
Se BaseAddress não for NULL, qualquer estrutura de MEM_ADDRESS_REQUIREMENTS fornecida deverá consistir em todos os zeros e o endereço base deverá ser um múltiplo da granularidade de alocação do sistema. Para determinar a granularidade de alocação, use a função GetSystemInfo.
[in] Size
O tamanho da região da memória a ser alocada, em bytes.
O tamanho deve ser sempre um múltiplo do tamanho da página.
Se BaseAddress não for NULL, a função alocará todas as páginas que contêm um ou mais bytes no intervalo de BaseAddress a BaseAddress+Size. Isso significa, por exemplo, que um intervalo de 2 bytes que ultrapassa um limite de página faz com que a função aloque ambas as páginas.
[in] AllocationType
O tipo de alocação de memória. Esse parâmetro deve conter um dos valores a seguir.
| Valor | Significado |
|---|---|
|
Aloca encargos de memória (do tamanho geral da memória e dos arquivos de paginação em disco) para as páginas de memória reservadas especificadas. A função também garante que, quando o chamador acessar inicialmente a memória, o conteúdo será zero. As páginas físicas reais não são alocadas, a menos/até que os endereços virtuais sejam realmente acessados.
Para reservar e confirmar páginas em uma etapa, chame Virtual2AllocFromApp com Tentar confirmar um intervalo de endereços específico especificando MEM_COMMIT sem MEM_RESERVE e umNULLBaseAddress falhar, a menos que todo o intervalo já tenha sido reservado. O código de erro resultante é ERROR_INVALID_ADDRESS. Uma tentativa de confirmar uma página que já está confirmada não faz com que a função falhe. Isso significa que você pode confirmar páginas sem primeiro determinar o estado de compromisso atual de cada página. |
|
Reserva um intervalo do espaço de endereço virtual do processo sem alocar nenhum armazenamento físico real na memória ou no arquivo de paginação no disco.
Você pode confirmar páginas reservadas em chamadas subsequentes para a função Virtual2AllocFromApp. Para reservar e confirmar páginas em uma etapa, chame Virtual2AllocFromApp com MEM_COMMIT | MEM_RESERVE. Outras funções de alocação de memória, como malloc e LocalAlloc, não podem usar um intervalo reservado de memória até que seja liberado. |
|
Substitui um espaço reservado por uma alocação privada normal. Há suporte apenas para exibições de seção com suporte de dados/pf (sem imagens, memória física etc.). Quando você substitui um espaço reservado, BaseAddress e Size deve corresponder exatamente aos do espaço reservado e qualquer estrutura de MEM_ADDRESS_REQUIREMENTS fornecida deve consistir em todos os zeros.
Depois de substituir um espaço reservado por uma alocação privada, para liberar essa alocação de volta para um espaço reservado, consulte o parâmetro Um espaço reservado é um tipo de região de memória reservada. |
|
Para criar um espaço reservado, chame Um espaço reservado é um tipo de região de memória reservada. |
|
Indica que os dados no intervalo de memória especificado por Usar esse valor não garante que o intervalo operado com MEM_RESET conterá zeros. Se você quiser que o intervalo contenha zeros, descompromisse a memória e, em seguida, recomunha-a. Quando você especifica MEM_RESET, a função Virtual2AllocFromApp ignora o valor de Protection. No entanto, você ainda deve definir Protection para um valor de proteção válido, como PAGE_NOACCESS. Virtual2AllocFromApp retornará um erro se você usar MEM_RESET e o intervalo de memória for mapeado para um arquivo. Uma exibição compartilhada só será aceitável se ela for mapeada para um arquivo de paginação. |
|
MEM_RESET_UNDO só deve ser chamado em um intervalo de endereços ao qual MEM_RESET foi aplicado com êxito anteriormente. Indica que os dados no intervalo de memória especificado pelo BaseAddress e Size é de interesse do chamador e tenta reverter os efeitos de MEM_RESET. Se a função for bem-sucedida, isso significa que todos os dados no intervalo de endereços especificado estão intactos. Se a função falhar, pelo menos alguns dos dados no intervalo de endereços serão substituídos por zeros.
Esse valor não pode ser usado com qualquer outro valor. Se MEM_RESET_UNDO for chamado em um intervalo de endereços que não foi MEM_RESET anteriormente, o comportamento será indefinido. Quando você especifica MEM_RESET, a função Virtual2AllocFromApp ignora o valor de Protection. No entanto, você ainda deve definir Protection para um valor de proteção válido, como PAGE_NOACCESS. |
Esse parâmetro também pode especificar os valores a seguir, conforme indicado.
| Valor | Significado |
|---|---|
|
Aloca memória usando de suporte de página grande.
O tamanho e o alinhamento devem ser múltiplos do mínimo de página grande. Para obter esse valor, use a função GetLargePageMinimum. Se você especificar esse valor, também deverá especificar MEM_RESERVE e MEM_COMMIT. |
|
Reserva um intervalo de endereços que pode ser usado para mapear páginas do AWE ( de Extensões de Janela de Endereço).
Esse valor deve ser usado com MEM_RESERVE e nenhum outro valor. |
|
Aloca memória no endereço mais alto possível. Isso pode ser mais lento do que as alocações regulares, especialmente quando há muitas alocações. |
|
Faz com que o sistema acompanhe as páginas gravadas na região alocada. Se você especificar esse valor, também deverá especificar MEM_RESERVE.
Para recuperar os endereços das páginas que foram gravadas desde que a região foi alocada ou o estado de acompanhamento de gravação foi redefinido, chame a função GetWriteWatch. Para redefinir o estado de controle de gravação, chame GetWriteWatch ou ResetWriteWatch. O recurso de acompanhamento de gravação permanece habilitado para a região de memória até que a região seja liberada. |
[in] PageProtection
A proteção de memória para a região das páginas a ser alocada. Se as páginas estiverem sendo confirmadas, você poderá especificar uma das constantes de proteção de memória . As seguintes constantes geram um erro:
- PAGE_EXECUTE
- PAGE_EXECUTE_READ
- PAGE_EXECUTE_READWRITE
- PAGE_EXECUTE_WRITECOPY
[in, out, optional] ExtendedParameters
Um ponteiro opcional para um ou mais parâmetros estendidos do tipo MEM_EXTENDED_PARAMETER. Cada um desses valores de parâmetro estendidos pode ter um campo Type de MemExtendedParameterAddressRequirements ou MemExtendedParameterNumaNode. Se nenhum
[in] ParameterCount
O número de parâmetros estendidos apontados por ExtendedParameters.
Valor de retorno
Se a função for bem-sucedida, o valor retornado será o endereço base da região alocada de páginas.
Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.
Observações
Essa API ajuda a dar suporte a jogos de alto desempenho e aplicativos de servidor, que têm requisitos específicos em relação ao gerenciamento de seu espaço de endereço virtual. Por exemplo, mapeando memória sobre uma região reservada anteriormente; isso é útil para implementar um buffer de anel de encapsulamento automático. E alocar memória com alinhamento específico; por exemplo, para permitir que seu aplicativo confirme regiões grandes/enormes mapeadas por página sob demanda.
Você pode chamar Virtual2AllocFromApp de aplicativos da Windows Store com funcionalidades just-in-time (JIT) para usar a funcionalidade JIT. O aplicativo deve incluir a funcionalidade codeGeneration no arquivo de manifesto do aplicativo para usar recursos JIT.
Cada página tem um estado de página associado. A função Virtual2AllocFromApp pode executar as seguintes operações:
- Confirmar uma região de páginas reservadas
- Reservar uma região de páginas gratuitas
- Reservar e confirmar simultaneamente uma região de páginas gratuitas
Você pode usar virtual2AllocFromApp para reservar um bloco de páginas e, em seguida, fazer chamadas adicionais para Virtual2AllocFromApp para confirmar páginas individuais do bloco reservado. Isso permite que um processo reserve um intervalo de seu espaço de endereço virtual sem consumir armazenamento físico até que seja necessário.
Se o parâmetro BaseAddress não for NULL, a função usará os parâmetros BaseAddress e Size para calcular a região das páginas a serem alocadas. O estado atual de todo o intervalo de páginas deve ser compatível com o tipo de alocação especificado pelo parâmetro AllocationType. Caso contrário, a função falhará e nenhuma das páginas será alocada. Esse requisito de compatibilidade não impede a confirmação de uma página já confirmada, conforme mencionado anteriormente.
Virtual2AllocFromApp não permite a criação de páginas executáveis.
A função
A função
Ao criar uma região que será executável, o programa de chamada é responsável por garantir a coerência do cache por meio de uma chamada apropriada para FlushInstructionCache depois que o código tiver sido definido em vigor. Caso contrário, as tentativas de executar código fora da região recém-executável podem produzir resultados imprevisíveis.
Exemplos
Para obter exemplos de código, consulte Virtual2Alloc.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10 [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2016 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | memoryapi.h (inclua Windows.h) |
| biblioteca | WindowsApp.lib |
| de DLL |
Kernel32.dll |
Consulte também
Funções de gerenciamento de memória