IDXGIFactory2::RegisterOcclusionStatusEvent-Methode (dxgi1_2.h)

  • Artikel

Registriert, um Benachrichtigungen über Änderungen in der Okklusion status mithilfe der Ereignissignalisierung zu erhalten.

Syntax

HRESULT RegisterOcclusionStatusEvent(
  [in]  HANDLE hEvent,
  [out] DWORD  *pdwCookie
);

Parameter

[in] hEvent

Ein Handle für das Ereignisobjekt, das das Betriebssystem festlegt, wenn eine Benachrichtigung über okklusion status Änderung auftritt. Die CreateEvent- oder OpenEvent-Funktion gibt dieses Handle zurück.

[out] pdwCookie

Ein Zeiger auf einen Schlüsselwert, den eine Anwendung an die IDXGIFactory2::UnregisterOcclusionStatus-Methode übergeben kann, um die Registrierung des Benachrichtigungsereignisses aufzuheben, das hEvent angibt.

Rückgabewert

RegisterOcclusionStatusEvent gibt Folgendes zurück:

  • S_OK, wenn die Methode das Ereignis erfolgreich registriert hat.
  • E_OUTOFMEMORY, wenn arbeitsspeicher nicht verfügbar ist, um den Vorgang abzuschließen.
  • DXGI_ERROR_INVALID_CALL , wenn hEvent kein gültiges Handle oder kein Ereignishandle ist.
  • 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 RegisterOcclusionStatusEvent mit E_NOTIMPL fehl. Weitere Informationen zum Plattformupdate für Windows 7 finden Sie unter Plattformupdate für Windows 7.

Hinweise

Wenn Sie RegisterOcclusionStatusEvent mehrmals mit demselben Ereignishandle aufrufen, schlägt RegisterOcclusionStatusEvent mit DXGI_ERROR_INVALID_CALL fehl.

Wenn Sie RegisterOcclusionStatusEvent mehrmals mit den verschiedenen Ereignishandles aufrufen, registriert RegisterOcclusionStatusEvent die Ereignisse ordnungsgemäß.

Anforderungen

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

Weitere Informationen

IDXGIFactory2