Funzione DiscardVirtualMemory (memoryapi.h)

Articolo
08/24/2023

Rimuove il contenuto della memoria di un intervallo di pagine di memoria, senza rimuovere la memoria. Il contenuto della memoria eliminata non è definito e deve essere riscritto dall'applicazione.

Sintassi

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

Parametri

[in] VirtualAddress

Indirizzo iniziale allineato alla pagina della memoria da eliminare.

[in] Size

Dimensioni, in byte, dell'area di memoria da eliminare. Le dimensioni devono essere un multiplo intero delle dimensioni della pagina di sistema.

Valore restituito

ERROR_SUCCESS in caso di esito positivo; un codice di errore di sistema in caso contrario.

Commenti

Se DiscardVirtualMemory ha esito negativo, il contenuto dell'area non viene modificato.

Usare questa funzione per rimuovere il contenuto della memoria non più necessario, mantenendo il commit dell'area di memoria stessa. L'eliminazione della memoria può restituire ram fisica al sistema. Quando l'area della memoria viene nuovamente accessibile dall'applicazione, la RAM di backup viene ripristinata e il contenuto della memoria non è definito.

Importante Le chiamate a DiscardVirtualMemory avranno esito negativo se la protezione della memoria non è PAGE_READWRITE.

Requisiti


Client minimo supportato	Windows 8.1 Update [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 R2 Update [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	memoryapi.h (include Windows.h, Memoryapi.h)
Libreria	onecore.lib
DLL	Kernel32.dll