IDXGISwapChain1::GetRestrictToOutput-Methode (dxgi1_2.h)

Ruft die Ausgabe (den Anzeigemonitor) ab, auf die Sie den Inhalt eines aktuellen Vorgangs einschränken können.

Syntax

HRESULT GetRestrictToOutput(
  [out] IDXGIOutput **ppRestrictToOutput
);

Parameter

[out] ppRestrictToOutput

Ein Zeiger auf einen Puffer, der einen Zeiger auf die IDXGIOutput-Schnittstelle für die Restrict-to-Ausgabe empfängt. Eine Anwendung übergibt diesen Zeiger an IDXGIOutput in einem Aufruf der IDXGIFactory2::CreateSwapChainForHwnd,IDXGIFactory2::CreateSwapChainForCoreWindow oder IDXGIFactory2::CreateSwapChainForComposition-Methode, um die Swapchain zu erstellen.

Rückgabewert

Gibt S_OK zurück, wenn die auf einschränkende Ausgabe erfolgreich abgerufen wurde. Gibt andernfalls E_INVALIDARG zurück, wenn der Zeiger ungültig ist.

Hinweise

Wenn die Methode erfolgreich ist, füllt die Laufzeit den Puffer bei ppRestrictToOutput mit einem Zeiger auf die Restrict-to-Ausgabeschnittstelle. Für diese Einschränkungsausgabeschnittstelle wird die Verweisanzahl erhöht. Wenn Sie damit fertig sind, stellen Sie sicher, dass Sie die Schnittstelle freigeben, um einen Speicherverlust zu vermeiden.

Die Ausgabe gehört auch dem Adapter, auf dem das Gerät der Swapchain erstellt wurde.

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

IDXGISwapChain1