IDXGIFactory2::RegisterOcclusionStatusWindow-Methode (dxgi1_2.h)
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 |