Compartilhar via

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

  • Artigo

Altera a cor da tela de fundo da cadeia de troca.

Sintaxe

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

Parâmetros

[in] pColor

Um ponteiro para uma estrutura de DXGI_RGBA que especifica a cor da tela de fundo a ser definida.

Valor retornado

SetBackgroundColor retorna:

  • S_OK se ele definir com êxito a cor da tela de fundo.
  • E_INVALIDARG se o parâmetro pColor estiver incorreto, por exemplo, pColor será NULL ou qualquer um dos valores de ponto flutuante dos membros de DXGI_RGBA aos quais os pontos pColor estão fora do intervalo de 0,0 a 1,0.
  • Possivelmente outros códigos de erro descritos no tópico DXGI_ERROR .

Atualização de plataforma para Windows 7: No Windows 7 ou no Windows Server 2008 R2 com o Platform Update para Windows 7 instalado, SetBackgroundColor falha com E_NOTIMPL. Para obter mais informações sobre a Atualização de Plataforma para Windows 7, consulte Atualização de plataforma para Windows 7.

Comentários

A cor da tela de fundo afeta apenas as cadeias de troca criadas com DXGI_SCALING_NONE no modo de janela. Você passa esse valor em uma chamada para IDXGIFactory2::CreateSwapChainForHwnd, IDXGIFactory2::CreateSwapChainForCoreWindow ou IDXGIFactory2::CreateSwapChainForComposition. Normalmente, a cor da tela de fundo não é visível, a menos que o conteúdo da cadeia de troca seja menor que a janela de destino.

Quando você define a cor da tela de fundo, ela não é imediatamente realizada. Ele entra em vigor em conjunto com sua próxima chamada para o método IDXGISwapChain1::P resent1 . Os sinalizadores de DXGI_PRESENT que você passa para IDXGISwapChain1::P resent1 podem ajudar a obter o efeito necessário. Por exemplo, se você chamar SetBackgroundColor e chamar IDXGISwapChain1::P resent1 com o parâmetro Flags definido como DXGI_PRESENT_DO_NOT_SEQUENCE, você alterará apenas a cor da tela de fundo sem alterar o conteúdo exibido da cadeia de troca.

Quando você chama o método IDXGISwapChain1::P resent1 para exibir o conteúdo da cadeia de troca, IDXGISwapChain1::P resent1 usa o valor DXGI_ALPHA_MODE especificado no membro AlphaMode da estrutura DXGI_SWAP_CHAIN_DESC1 para determinar como lidar com um membro da estrutura DXGI_RGBA , o valor alfa da cor da tela de fundo, que obtém a transparência da janela. Por exemplo, se AlphaMode for DXGI_ALPHA_MODE_IGNORE, IDXGISwapChain1::P resent1 ignorará um membro do DXGI_RGBA.

Nota Como todos os dados de apresentação, recomendamos que você execute operações de ponto flutuante em um espaço de cores linear. Quando a área de trabalho está em um modo de profundidade de cor de bit fixo, o sistema operacional converte dados de cor linear em dados RGB padrão (sRGB, espaço corrigido gama 2.2) para compor na tela. Para obter mais informações, consulte Convertendo dados para o espaço de cor.
 

Requisitos

   
Cliente mínimo com suporte Windows 8 e Platform Update para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 e Platform Update para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho dxgi1_2.h
Biblioteca Dxgi.lib

Confira também

DXGI_SCALING

IDXGISwapChain1

IDXGISwapChain1::GetBackgroundColor