Función ReclaimVirtualMemory (memoryapi.h)
Reclama un intervalo de páginas de memoria que se ofrecieron al sistema con OfferVirtualMemory.
Si se ha descartado la memoria ofrecida, el contenido de la región de memoria no está definido y la aplicación debe volver a escribirla. Si la memoria ofrecida no se ha descartado, se reclama intacta.
Sintaxis
DWORD ReclaimVirtualMemory(
[in] void const *VirtualAddress,
[in] SIZE_T Size
);
Parámetros
[in] VirtualAddress
Dirección inicial alineada con la página de la memoria que se va a reclamar.
[in] Size
Tamaño, en bytes, de la región de memoria que se va a reclamar. El tamaño debe ser un entero múltiplo del tamaño de página del sistema.
Valor devuelto
Devuelve ERROR_SUCCESS si se realizó correctamente y la memoria se recuperó intacta.
Devuelve ERROR_BUSY si se ejecuta correctamente, pero la aplicación ha descartado la memoria y debe volver a escribirla. En este caso, el contenido de la región de memoria no está definido.
Devuelve un código de error del sistema de lo contrario.
Comentarios
La aplicación puede usar las páginas de memoria reclamadas y se escribirá en el archivo de paginación del sistema si se produce la paginación.
Si la función devuelve ERROR_SUCCESS, los datos de las páginas reclamadas son válidos. Si la función devuelve ERROR_BUSY, el sistema descarta los datos de las páginas reclamadas y ya no es válido. Por este motivo, la memoria solo se debe ofrecer al sistema si la aplicación no necesita o puede regenerar los datos.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8.1 Update [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 |