ReclaimVirtualMemory-Funktion (memoryapi.h)

Artikel
08/24/2023

Gibt eine Reihe von Speicherseiten zurück, die dem System mit OfferVirtualMemory angeboten wurden.

Wenn der angebotene Arbeitsspeicher verworfen wurde, ist der Inhalt des Speicherbereichs nicht definiert und muss von der Anwendung neu geschrieben werden. Wenn der angebotene Arbeitsspeicher nicht verworfen wurde, wird er intakt zurückgewonnen.

Syntax

DWORD ReclaimVirtualMemory(
  [in] void const *VirtualAddress,
  [in] SIZE_T     Size
);

Parameter

[in] VirtualAddress

Seitenbündige Startadresse des arbeitsspeicherbezogenen Speichers, der freigegeben werden soll.

[in] Size

Größe des zurückzugebenden Speicherbereichs in Byte. Die Größe muss ein ganzzahliges Vielfaches der Systemseitengröße sein.

Rückgabewert

Gibt ERROR_SUCCESS zurück, wenn erfolgreich war und der Arbeitsspeicher intakt wieder freigegeben wurde.

Gibt ERROR_BUSY zurück, wenn erfolgreich, aber der Arbeitsspeicher verworfen wurde und von der Anwendung neu geschrieben werden muss. In diesem Fall ist der Inhalt des Speicherbereichs nicht definiert.

Gibt andernfalls einen Systemfehlercode zurück.

Hinweise

Zurückgewonnene Speicherseiten können von der Anwendung verwendet werden und werden beim Paging in die System-Auslagerungsdatei geschrieben.

Wenn die Funktion ERROR_SUCCESS zurückgibt, sind die Daten auf den beanspruchten Seiten gültig. Wenn die Funktion ERROR_BUSY zurückgibt, wurden die Daten auf den beanspruchten Seiten vom System verworfen und sind nicht mehr gültig. Aus diesem Grund sollte dem System nur Arbeitsspeicher zur Verfügung gestellt werden, wenn die Anwendung die Daten nicht benötigt oder neu generieren kann.

Anforderungen

Anforderung	Wert
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