Método IDXGISwapChain1::SetBackgroundColor (dxgi1_2.h)

Cambia el color de fondo de la cadena de intercambio.

Sintaxis

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

Parámetros

[in] pColor

Puntero a una estructura DXGI_RGBA que especifica el color de fondo que se va a establecer.

Valor devuelto

SetBackgroundColor devuelve:

• S_OK si establece correctamente el color de fondo.
• E_INVALIDARG si el parámetro pColor es incorrecto, por ejemplo, pColor es NULL o cualquiera de los valores de punto flotante de los miembros de DXGI_RGBA a los que los puntos pColor están fuera del intervalo comprendido entre 0,0 y 1,0.
• Posiblemente otros códigos de error que se describen en el tema DXGI_ERROR .

Actualización de la plataforma para Windows 7: En Windows 7 o Windows Server 2008 R2 con la actualización de plataforma para Windows 7 instalada, Se produce un error en SetBackgroundColor con E_NOTIMPL. Para obtener más información sobre la actualización de plataforma para Windows 7, consulta Actualización de plataforma para Windows 7.

Comentarios

El color de fondo afecta solo a las cadenas de intercambio que se crean con DXGI_SCALING_NONE en modo con ventanas. Pase este valor en una llamada a IDXGIFactory2::CreateSwapChainForHwnd, IDXGIFactory2::CreateSwapChainForCoreWindow o IDXGIFactory2::CreateSwapChainForComposition. Normalmente, el color de fondo no es visible a menos que el contenido de la cadena de intercambio sea menor que la ventana de destino.

Cuando se establece el color de fondo, no se realiza inmediatamente. Tiene efecto junto con la siguiente llamada al método IDXGISwapChain1::P resent1 . Las marcas de DXGI_PRESENT que pasa a IDXGISwapChain1::P resent1 pueden ayudar a lograr el efecto que necesita. Por ejemplo, si llama a SetBackgroundColor y, a continuación, llama a IDXGISwapChain1::P resent1 con el parámetro Flags establecido en DXGI_PRESENT_DO_NOT_SEQUENCE, solo cambia el color de fondo sin cambiar el contenido mostrado de la cadena de intercambio.

Cuando se llama al método IDXGISwapChain1::P resent1 para mostrar el contenido de la cadena de intercambio, IDXGISwapChain1::P resent1 usa el valor DXGI_ALPHA_MODE especificado en el miembro AlphaMode de la estructura DXGI_SWAP_CHAIN_DESC1 para determinar cómo controlar el miembro de la estructura DXGI_RGBA , el valor alfa del color de fondo, que logra la transparencia de la ventana. Por ejemplo, si AlphaMode es DXGI_ALPHA_MODE_IGNORE, IDXGISwapChain1::P resent1 omite el miembro de DXGI_RGBA.

Requisitos

Consulte también

DXGI_SCALING

IDXGISwapChain1

IDXGISwapChain1::GetBackgroundColor