QueryMemoryResourceNotification-Funktion (memoryapi.h)

  • Artikel

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

Siehe auch

CreateMemoryResourceNotification

Speicherverwaltungsfunktionen