IDXGIFactory2::RegisterOcclusionStatusWindow-Methode (dxgi1_2.h)

  • Artikel

Registriert ein Anwendungsfenster, um Benachrichtigungen über Änderungen der Okklusion status zu empfangen.

Syntax

HRESULT RegisterOcclusionStatusWindow(
  [in]  HWND  WindowHandle,
  [in]  UINT  wMsg,
  [out] DWORD *pdwCookie
);

Parameter

[in] WindowHandle

Das Handle des Fensters, an das eine Benachrichtigungsnachricht gesendet werden soll, wenn eine Verdeckung status Änderung auftritt.

[in] wMsg

Gibt die zu sendende Benachrichtigungsnachricht an.

[out] pdwCookie

Ein Zeiger auf einen Schlüsselwert, den eine Anwendung an die IDXGIFactory2::UnregisterOcclusionStatus-Methode übergeben kann, um die Registrierung der Benachrichtigungsmeldung aufzuheben, die wMsg angibt.

Rückgabewert

RegisterOcclusionStatusWindow gibt Folgendes zurück:

  • S_OK, wenn das Fenster erfolgreich registriert wurde.
  • E_OUTOFMEMORY, wenn arbeitsspeicher nicht verfügbar ist, um den Vorgang abzuschließen.
  • DXGI_ERROR_INVALID_CALL , wenn WindowHandle kein gültiges Fensterhandle ist oder nicht das Fensterhandle, das der aktuelle Prozess besitzt.
  • Möglicherweise andere Fehlercodes, die im Thema DXGI_ERROR beschrieben werden.

Plattformupdate für Windows 7: Unter Windows 7 oder Windows Server 2008 R2 mit installiertem Plattformupdate für Windows 7 schlägt RegisterOcclusionStatusWindow mit E_NOTIMPL fehl. Weitere Informationen zum Plattformupdate für Windows 7 finden Sie unter Plattformupdate für Windows 7.

Hinweise

Apps wählen die Windows-Nachricht aus, die Windows sendet, wenn sich die Okklusion status ändert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 und Plattformupdate für Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile dxgi1_2.h
Bibliothek Dxgi.lib

Weitere Informationen

IDXGIFactory2