IDXGIFactory2::RegisterOcclusionStatusEvent-Methode (dxgi1_2.h)

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

Weitere Informationen

IDXGIFactory2