Metodo IDXGISwapChain1::SetBackgroundColor (dxgi1_2.h)

Articolo
08/23/2023

Modifica il colore di sfondo della catena di scambio.

Sintassi

HRESULT SetBackgroundColor(
  [in] const DXGI_RGBA *pColor
);

Parametri

[in] pColor

Puntatore a una struttura DXGI_RGBA che specifica il colore di sfondo da impostare.

Valore restituito

SetBackgroundColor restituisce:

S_OK se è stato impostato correttamente il colore di sfondo.
E_INVALIDARG se il parametro pColor non è corretto, ad esempio pColor è NULL o uno dei valori a virgola mobile dei membri di DXGI_RGBAa cui i punti pColor si trovano all'esterno dell'intervallo compreso tra 0,0 e 1,0.
Eventualmente altri codici di errore descritti nell'argomento DXGI_ERROR .

Aggiornamento della piattaforma per Windows 7: In Windows 7 o Windows Server 2008 R2 con l'aggiornamento della piattaforma per Windows 7 installato , SetBackgroundColor non riesce con E_NOTIMPL. Per altre informazioni sull'aggiornamento della piattaforma per Windows 7, vedere Platform Update per Windows 7.

Commenti

Il colore di sfondo influisce solo sulle catene di scambio create con DXGI_SCALING_NONE in modalità finestra. Si passa questo valore in una chiamata a IDXGIFactory2::CreateSwapChainForHwnd, IDXGIFactory2::CreateSwapChainForCoreWindow o IDXGIFactory2:: CreateSwapChainForComposition. In genere, il colore di sfondo non è visibile a meno che il contenuto della catena di scambio non sia minore della finestra di destinazione.

Quando si imposta il colore di sfondo, non viene immediatamente realizzato. Si verifica un effetto in combinazione con la chiamata successiva al metodo IDXGISwapChain1::P resent1 . I flag di DXGI_PRESENT passati a IDXGISwapChain1::P resent1 consentono di ottenere l'effetto richiesto. Ad esempio, se si chiama SetBackgroundColor e quindi si chiama IDXGISwapChain1::P resent1 con il parametro Flags impostato su DXGI_PRESENT_DO_NOT_SEQUENCE, si modifica solo il colore di sfondo senza modificare il contenuto visualizzato della catena di scambio.

Quando si chiama il metodo IDXGISwapChain1::P resent1 per visualizzare il contenuto della catena di scambio, IDXGISwapChain1::P resent1 usa il valore DXGI_ALPHA_MODE specificato nel membro AlfaModedella struttura DXGI_SWAP_CHAIN_DESC1 per determinare come gestire il membrodella struttura DXGI_RGBA , il valore alfa del colore di sfondo, che ottiene la trasparenza della finestra. Ad esempio, se AlphaMode è DXGI_ALPHA_MODE_IGNORE, IDXGISwapChain1::P resent1 ignora il membro di DXGI_RGBA.

Nota Come tutti i dati di presentazione, è consigliabile eseguire operazioni a virgola mobile in uno spazio colore lineare. Quando il desktop si trova in modalità di profondità del colore a bit fisso, il sistema operativo converte i dati di colore lineare in dati RGB standard (sRGB, gamma 2.2 spazio corretto) per comporre sullo schermo. Per altre informazioni, vedere Conversione dei dati per lo spazio dei colori.

Requisiti


Client minimo supportato	Windows 8 e Platform Update per Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 e Aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	dxgi1_2.h
Libreria	Dxgi.lib

Vedi anche

DXGI_SCALING

IDXGISwapChain1

IDXGISwapChain1::GetBackgroundColor

Condividi tramite