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

  • Artículo

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.

Nota Al igual que todos los datos de presentación, se recomienda realizar operaciones de punto flotante en un espacio de color lineal. Cuando el escritorio está en modo de profundidad de color de bits fijo, el sistema operativo convierte los datos de color lineales en datos RGB estándar (sRGB, espacio corregido gamma 2.2) para redactar en la pantalla. Para obtener más información, consulte Conversión de datos para el espacio de colores.
 

Requisitos

   
Cliente mínimo compatible Actualización de windows 8 y plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 y Actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado dxgi1_2.h
Library Dxgi.lib

Consulte también

DXGI_SCALING

IDXGISwapChain1

IDXGISwapChain1::GetBackgroundColor