Función DiscardVirtualMemory (memoryapi.h)

Artículo
08/24/2023

Descarta el contenido de memoria de un intervalo de páginas de memoria, sin omitir la memoria. El contenido de la memoria descartada no está definido y la aplicación debe volver a escribirla.

Sintaxis

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

Parámetros

[in] VirtualAddress

Dirección inicial alineada con la página de la memoria que se va a descartar.

[in] Size

Tamaño, en bytes, de la región de memoria que se va a descartar. El tamaño debe ser un entero múltiplo del tamaño de página del sistema.

Valor devuelto

ERROR_SUCCESS si se realiza correctamente; Un código de error del sistema de lo contrario.

Comentarios

Si se produce un error en DiscardVirtualMemory , el contenido de la región no se modifica.

Use esta función para descartar el contenido de la memoria que ya no son necesarios, a la vez que mantiene confirmada la propia región de memoria. Descartar la memoria puede devolver la RAM física al sistema. Cuando la aplicación accede de nuevo a la región de memoria, se restaura la RAM de respaldo y el contenido de la memoria no está definido.

Importante Las llamadas a DiscardVirtualMemory producirán un error si la protección de memoria no está PAGE_READWRITE.

Requisitos


Cliente mínimo compatible	Windows 8.1 Actualizar [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Actualización de Windows Server 2012 R2 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	memoryapi.h (incluya Windows.h, Memoryapi.h)
Library	onecore.lib
Archivo DLL	Kernel32.dll