IDXGIFactory2::RegisterStereoStatusEvent-Methode (dxgi1_2.h)

Registriert, um Benachrichtigungen über Änderungen in Stereo-status mithilfe von Ereignissignalisierung zu erhalten.

Syntax

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

Parameter

[in] hEvent

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

[out] pdwCookie

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

Rückgabewert

RegisterStereoStatusEvent gibt Folgendes zurück:

  • S_OK, wenn das Ereignis erfolgreich registriert wurde.
  • E_OUTOFMEMORY, wenn kein Arbeitsspeicher verfügbar ist, um den Vorgang abzuschließen.
  • Möglicherweise weitere 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 RegisterStereoStatusEvent mit E_NOTIMPL fehl. Weitere Informationen zum Plattformupdate für Windows 7 finden Sie unter Plattformupdate für Windows 7.

Anforderungen

Anforderung Wert
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