Condividi tramite


Funzione DiscardVirtualMemory (memoryapi.h)

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

Vedere anche

Funzioni di gestione della memoria

OfferVirtualMemory

ReclaimVirtualMemory

Funzioni di memoria virtuale

Virtualalloc

Virtualfree

VirtualLock

VirtualQuery