IDXGISwapChain1::SetBackgroundColor-Methode (dxgi1_2.h)
Ändert die Hintergrundfarbe der Swapchain.
Syntax
HRESULT SetBackgroundColor(
[in] const DXGI_RGBA *pColor
);
Parameter
[in] pColor
Ein Zeiger auf eine DXGI_RGBA Struktur, die die festzulegende Hintergrundfarbe angibt.
Rückgabewert
SetBackgroundColor gibt Folgendes zurück:
- S_OK, wenn die Hintergrundfarbe erfolgreich festgelegt wurde.
- E_INVALIDARG, wenn der pColor-Parameter falsch ist, z. B. ist pColor NULL oder einer der Gleitkommawerte der Member von DXGI_RGBA , zu denen pColor-Punkte außerhalb des Bereichs von 0,0 bis 1,0 liegen.
- 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 SetBackgroundColor mit E_NOTIMPL fehl. Weitere Informationen zum Plattformupdate für Windows 7 finden Sie unter Plattformupdate für Windows 7.
Hinweise
Die Hintergrundfarbe wirkt sich nur auf Swapchains aus, die Sie mit DXGI_SCALING_NONE im Fenstermodus erstellen. Sie übergeben diesen Wert in einem Aufruf von IDXGIFactory2::CreateSwapChainForHwnd, IDXGIFactory2::CreateSwapChainForCoreWindow oder IDXGIFactory2::CreateSwapChainForComposition. In der Regel ist die Hintergrundfarbe nicht sichtbar, es sei denn, der Swapchaininhalt ist kleiner als das Zielfenster.
Wenn Sie die Hintergrundfarbe festlegen, wird sie nicht sofort erkannt. Sie wird in Verbindung mit Ihrem nächsten Aufruf der IDXGISwapChain1::P resent1-Methode wirksam. Die DXGI_PRESENT Flags, die Sie an IDXGISwapChain1::P resent1 übergeben, können dazu beitragen, den gewünschten Effekt zu erzielen. Wenn Sie beispielsweise SetBackgroundColor aufrufen und dann IDXGISwapChain1::P resent1 aufrufen, wobei der Flags-Parameter auf DXGI_PRESENT_DO_NOT_SEQUENCE festgelegt ist, ändern Sie nur die Hintergrundfarbe, ohne den angezeigten Inhalt der Swapchain zu ändern.
Wenn Sie die IDXGISwapChain1::P resent1-Methode aufrufen, um Inhalte der Swapchain anzuzeigen, verwendet IDXGISwapChain1::P resent1 den DXGI_ALPHA_MODE Wert, der im AlphaMode-Member der DXGI_SWAP_CHAIN_DESC1-Struktur angegeben ist, um zu bestimmen, wie das Element der DXGI_RGBA-Struktur , der Alphawert der Hintergrundfarbe, behandelt werden soll. die Fenstertransparenz erreicht. Wenn AlphaMode beispielsweise DXGI_ALPHA_MODE_IGNORE ist, ignoriert IDXGISwapChain1::P resent1 das Element von DXGI_RGBA.
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 |