Funzione ReclaimVirtualMemory (memoryapi.h)
Recupera un intervallo di pagine di memoria offerte al sistema con OfferVirtualMemory.
Se la memoria offerta è stata eliminata, il contenuto dell'area di memoria non è definito e deve essere riscritto dall'applicazione. Se la memoria offerta non è stata eliminata, viene recuperata intatta.
Sintassi
DWORD ReclaimVirtualMemory(
[in] void const *VirtualAddress,
[in] SIZE_T Size
);
Parametri
[in] VirtualAddress
Indirizzo iniziale allineato alla pagina della memoria da recuperare.
[in] Size
Dimensioni, in byte, dell'area di memoria da recuperare. Le dimensioni devono essere un numero intero multiplo delle dimensioni della pagina di sistema.
Valore restituito
Restituisce ERROR_SUCCESS se ha esito positivo e la memoria è stata recuperata intatta.
Restituisce ERROR_BUSY se ha esito positivo, ma la memoria è stata eliminata e deve essere riscritta dall'applicazione. In questo caso, il contenuto dell'area di memoria non è definito.
Restituisce un codice di errore di sistema in caso contrario.
Commenti
Le pagine di memoria recuperate possono essere usate dall'applicazione e verranno scritte nel file di paging di sistema se si verifica il paging.
Se la funzione restituisce ERROR_SUCCESS, i dati nelle pagine recuperate sono validi. Se la funzione restituisce ERROR_BUSY, i dati nelle pagine recuperate sono stati eliminati dal sistema e non sono più validi. Per questo motivo, la memoria deve essere offerta solo al sistema se l'applicazione non ha bisogno o può rigenerare i dati.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8.1 Update [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2012 aggiornamento R2 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | memoryapi.h (includono Windows.h, Memoryapi.h) |
| Libreria | onecore.lib |
| DLL | Kernel32.dll |