QueryMemoryResourceNotification-Funktion (memoryapi.h)
Ruft den Zustand des angegebenen Speicherressourcenobjekts ab.
Syntax
BOOL QueryMemoryResourceNotification(
[in] HANDLE ResourceNotificationHandle,
[out] PBOOL ResourceState
);
Parameter
[in] ResourceNotificationHandle
Ein Handle für ein Speicherressourcenbenachrichtigungsobjekt. Die CreateMemoryResourceNotification-Funktion gibt dieses Handle zurück.
[out] ResourceState
Der Speicher, auf den dieser Parameter verweist, empfängt den Zustand des Speicherressourcenbenachrichtigungsobjekts. Der Wert dieses Parameters wird auf TRUE festgelegt, wenn die angegebene Arbeitsspeicherbedingung vorhanden ist, und FALSE , wenn die angegebene Speicherbedingung nicht vorhanden ist.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Rufen Sie GetLastError auf, um weitere Fehlerinformationen zu erhalten.
Hinweise
Im Gegensatz zu den Wartefunktionen blockiert QueryMemoryResourceNotification den aufrufenden Thread nicht. Daher ist es eine effiziente Möglichkeit, den Zustand des physischen Arbeitsspeichers zu überprüfen, bevor sie mit einem Vorgang fortfahren.
Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie das _WIN32_WINNT Makro als 0x0501 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | memoryapi.h (einschließlich Windows.h, Memoryapi.h) |
| Bibliothek | onecore.lib |
| DLL | Kernel32.dll |