ReclaimVirtualMemory-Funktion (memoryapi.h)

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

Siehe auch

Speicherverwaltungsfunktionen

OfferVirtualMemory

Funktionen des virtuellen Speichers

VirtualAlloc

VirtualFree

VirtualLock

Virtualquery