Função ReclaimVirtualMemory (memoryapi.h)
Recupera um intervalo de páginas de memória que foram oferecidas ao sistema com OfferVirtualMemory.
Se a memória oferecida tiver sido descartada, o conteúdo da região de memória será indefinido e deverá ser reescrito pelo aplicativo. Se a memória oferecida não tiver sido descartada, ela será recuperada intacta.
Sintaxe
DWORD ReclaimVirtualMemory(
[in] void const *VirtualAddress,
[in] SIZE_T Size
);
Parâmetros
[in] VirtualAddress
Endereço inicial alinhado à página da memória a ser recuperada.
[in] Size
Tamanho, em bytes, da região de memória a ser recuperada. O tamanho deve ser um múltiplo inteiro do tamanho da página do sistema.
Retornar valor
Retorna ERROR_SUCCESS se tiver êxito e a memória foi recuperada intacta.
Retorna ERROR_BUSY se tiver êxito, mas a memória foi descartada e deve ser reescrita pelo aplicativo. Nesse caso, o conteúdo da região de memória é indefinido.
Retorna um código de erro do sistema caso contrário.
Comentários
As páginas de memória recuperadas podem ser usadas pelo aplicativo e serão gravadas no arquivo de paginação do sistema se ocorrer paginação.
Se a função retornar ERROR_SUCCESS, os dados nas páginas recuperadas serão válidos. Se a função retornar ERROR_BUSY, os dados nas páginas recuperadas serão descartados pelo sistema e não serão mais válidos. Por esse motivo, a memória só deverá ser oferecida ao sistema se o aplicativo não precisar ou puder regenerar os dados.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8.1 Update [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Atualização do Windows Server 2012 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | memoryapi.h (inclua Windows.h, Memoryapi.h) |
| Biblioteca | onecore.lib |
| DLL | Kernel32.dll |