IDXGISwapChain1::GetBackgroundColor-Methode (dxgi1_2.h)
Ruft die Hintergrundfarbe der Swapchain ab.
Syntax
HRESULT GetBackgroundColor(
[out] DXGI_RGBA *pColor
);
Parameter
[out] pColor
Ein Zeiger auf eine DXGI_RGBA Struktur, die die Hintergrundfarbe der Swapchain empfängt.
Rückgabewert
GetBackgroundColor gibt Folgendes zurück:
- S_OK, wenn die Hintergrundfarbe erfolgreich abgerufen wird.
- DXGI_ERROR_INVALID_CALL , wenn der pColor-Parameter ungültig ist, z. B. ist pColor NULL.
- Möglicherweise weitere Fehlercodes, die im Thema DXGI_ERROR beschrieben werden.
Hinweise
Hinweis Die von GetBackgroundColor abgerufene Hintergrundfarbe gibt nicht an, was der Bildschirm derzeit anzeigt. Die Hintergrundfarbe gibt an, was auf dem Bildschirm beim nächsten Aufruf der IDXGISwapChain1::P resent1-Methode angezeigt wird. Der Standardwert der Hintergrundfarbe ist Schwarz mit voller Deckkraft: 0,0,0,0,1.
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 |