IDXGIFactoryMedia::CreateSwapChainForCompositionSurfaceHandle-Methode (dxgi1_3.h)

Artikel
08/23/2023

Erstellt eine YUV-Swapkette für einen vorhandenen DirectComposition-Oberflächenhandle .

Syntax

HRESULT CreateSwapChainForCompositionSurfaceHandle(
  [in]           IUnknown                    *pDevice,
  [in, optional] HANDLE                      hSurface,
  [in]           const DXGI_SWAP_CHAIN_DESC1 *pDesc,
  [in, optional] IDXGIOutput                 *pRestrictToOutput,
  [out]          IDXGISwapChain1             **ppSwapChain
);

Parameter

[in] pDevice

Ein Zeiger auf das Direct3D-Gerät für die Swapchain. Dieser Parameter darf nicht NULL sein. Softwaretreiber wie D3D_DRIVER_TYPE_REFERENCE werden für Kompositionstauschketten nicht unterstützt.

[in, optional] hSurface

Ein Handle für eine vorhandene DirectComposition-Oberfläche . Dieser Parameter darf nicht NULL sein.

[in] pDesc

Ein Zeiger auf eine DXGI_SWAP_CHAIN_DESC1-Struktur für die Swap-Chain-Beschreibung. Dieser Parameter darf nicht NULL sein.

[in, optional] pRestrictToOutput

Ein Zeiger auf die IDXGIOutput-Schnittstelle für die Swapchain, auf die Inhalte beschränkt werden sollen. Wenn die Swapchain in eine andere Ausgabe verschoben wird, ist der Inhalt schwarz. Optional können Sie diesen Parameter auf ein Ausgabeziel festlegen, das DXGI_PRESENT_RESTRICT_TO_OUTPUT verwendet, um den Inhalt dieser Ausgabe einzuschränken. Wenn die Swapchain in eine andere Ausgabe verschoben wird, ist der Inhalt schwarz.

Sie müssen auch das DXGI_PRESENT_RESTRICT_TO_OUTPUT-Flag in einem aktuellen Aufruf übergeben, um zu erzwingen, dass der Inhalt in jeder anderen Ausgabe schwarz angezeigt wird. Wenn Sie den Inhalt auf eine andere Ausgabe beschränken möchten, müssen Sie eine neue Swapchain erstellen. Sie können Inhalte jedoch bedingt einschränken, basierend auf dem DXGI_PRESENT_RESTRICT_TO_OUTPUT-Flag .

Legen Sie diesen Parameter auf NULL fest, wenn Sie Den Inhalt nicht auf ein Ausgabeziel beschränken möchten.

[out] ppSwapChain

Ein Zeiger auf eine Variable, die einen Zeiger auf die IDXGISwapChain1-Schnittstelle für die von dieser Methode erstellte Swap chain empfängt.

Rückgabewert

CreateSwapChainForCompositionSurfaceHandle gibt Folgendes zurück:

S_OK, wenn eine Swapchain erfolgreich erstellt wurde.
E_OUTOFMEMORY, wenn arbeitsspeicher nicht verfügbar ist, um den Vorgang abzuschließen.
DXGI_ERROR_INVALID_CALL , wenn die aufrufende Anwendung ungültige Daten bereitgestellt hat, z. B. wenn pDesc, pYuvDecodeBuffers oder ppSwapChainNULL ist.
Möglicherweise andere Fehlercodes, die im DXGI_ERROR Thema beschrieben werden, die durch den Gerätetyp definiert sind, den Sie an pDevice übergeben.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dxgi1_3.h
Bibliothek	Dxgi.lib

Weitere Informationen

Verwenden Sie das DXGI-Flipmodell, um eine optimale Leistung zu erzielen.

IDXGIFactoryMedia

Freigeben über