Função DiscardVirtualMemory (memoryapi.h)

Artigo
08/24/2023

Descarta o conteúdo de memória de um intervalo de páginas de memória, sem descompactar a memória. O conteúdo da memória descartada é indefinido e deve ser reescrito pelo aplicativo.

Sintaxe

DWORD DiscardVirtualMemory(
  [in] PVOID  VirtualAddress,
  [in] SIZE_T Size
);

Parâmetros

[in] VirtualAddress

Endereço inicial alinhado à página da memória a ser descartada.

[in] Size

Tamanho, em bytes, da região de memória a ser descartada. O tamanho deve ser um múltiplo inteiro do tamanho da página do sistema.

Valor retornado

ERROR_SUCCESS se tiver êxito; caso contrário , um código de erro do sistema.

Comentários

Se DiscardVirtualMemory falhar, o conteúdo da região não será alterado.

Use essa função para descartar conteúdos de memória que não são mais necessários, mantendo a própria região de memória confirmada. Descartar a memória pode devolver a RAM física ao sistema. Quando a região da memória é acessada novamente pelo aplicativo, a RAM de suporte é restaurada e o conteúdo da memória é indefinido.

Importante As chamadas para DiscardVirtualMemory falharão se a proteção de memória não for PAGE_READWRITE.

Requisitos


Cliente mínimo com suporte	Windows 8.1 Atualizar [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