Função ReclaimVirtualMemory (memoryapi.h)

Artigo
02/28/2024

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