DiscardVirtualMemory-Funktion (memoryapi.h)

Artikel
08/24/2023

Verwirft den Speicherinhalt eines Bereichs von Speicherseiten, ohne den Arbeitsspeicher zu deaktivieren. Der Inhalt des verworfenen Arbeitsspeichers ist nicht definiert und muss von der Anwendung neu geschrieben werden.

Syntax

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

Parameter

[in] VirtualAddress

Seitenbündige Startadresse des zu verwerfenden Arbeitsspeichers.

[in] Size

Größe des zu verwerfenden Speicherbereichs in Bytes. Die Größe muss ein ganzzahliges Vielfaches der Systemseitengröße sein.

Rückgabewert

ERROR_SUCCESS bei Erfolgreicher Ausführung; Andernfalls ein Systemfehlercode .

Hinweise

Wenn DiscardVirtualMemory fehlschlägt , wird der Inhalt der Region nicht geändert.

Verwenden Sie diese Funktion, um nicht mehr benötigte Speicherinhalte zu verwerfen, während der Speicherbereich selbst festgeschrieben wird. Das Verwerfen von Arbeitsspeicher kann dem System physischen RAM zurückgeben. Wenn die Anwendung erneut auf den Speicherbereich zugreift, wird der unterstützende RAM wiederhergestellt, und der Inhalt des Arbeitsspeichers ist nicht definiert.

Wichtig Aufrufe von DiscardVirtualMemory schlagen fehl, wenn der Speicherschutz nicht PAGE_READWRITE ist.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8.1 Update [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 Update [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	memoryapi.h (einschließlich Windows.h, Memoryapi.h)
Bibliothek	onecore.lib
DLL	Kernel32.dll