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

Modifie la couleur d’arrière-plan de la chaîne d’échange.

Syntaxe

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

Paramètres

[in] pColor

Pointeur vers une structure de DXGI_RGBA qui spécifie la couleur d’arrière-plan à définir.

Valeur retournée

SetBackgroundColor retourne :

• S_OK s’il a correctement défini la couleur d’arrière-plan.
• E_INVALIDARG si le paramètre pColor est incorrect, par exemple, pColor a la valeur NULL ou l’une des valeurs à virgule flottante des membres de DXGI_RGBA sur lesquels pColor pointe en dehors de la plage comprise entre 0,0 et 1,0.
• Éventuellement d’autres codes d’erreur décrits dans la rubrique DXGI_ERROR .

Mise à jour de plateforme pour Windows 7 : Sur Windows 7 ou Windows Server 2008 R2 avec la mise à jour de plateforme pour Windows 7 installée, SetBackgroundColor échoue avec E_NOTIMPL. Pour plus d’informations sur la mise à jour de plateforme pour Windows 7, consultez Mise à jour de plateforme pour Windows 7.

Notes

La couleur d’arrière-plan affecte uniquement les chaînes d’échange que vous créez avec DXGI_SCALING_NONE en mode fenêtré. Vous passez cette valeur dans un appel à IDXGIFactory2::CreateSwapChainForHwnd, IDXGIFactory2::CreateSwapChainForCoreWindow ou IDXGIFactory2::CreateSwapChainForComposition. En règle générale, la couleur d’arrière-plan n’est pas visible, sauf si le contenu de la chaîne d’échange est plus petit que la fenêtre de destination.

Lorsque vous définissez la couleur d’arrière-plan, elle n’est pas immédiatement réalisée. Il prend effet conjointement avec votre prochain appel à la méthode IDXGISwapChain1::P resent1 . Les indicateurs de DXGI_PRESENT que vous passez à IDXGISwapChain1::P resent1 peuvent vous aider à obtenir l’effet dont vous avez besoin. Par exemple, si vous appelez SetBackgroundColor , puis que vous appelez IDXGISwapChain1::P resent1 avec le paramètre Flags défini sur DXGI_PRESENT_DO_NOT_SEQUENCE, vous modifiez uniquement la couleur d’arrière-plan sans modifier le contenu affiché de la chaîne d’échange.

Lorsque vous appelez la méthode IDXGISwapChain1::P resent1 pour afficher le contenu de la chaîne d’échange, IDXGISwapChain1::P resent1 utilise la valeur DXGI_ALPHA_MODE spécifiée dans le membre AlphaMode de la structure DXGI_SWAP_CHAIN_DESC1 pour déterminer comment gérer le membre a de la structure DXGI_RGBA , la valeur alpha de la couleur d’arrière-plan, qui permet d’obtenir la transparence de la fenêtre. Par exemple, si AlphaMode est DXGI_ALPHA_MODE_IGNORE, IDXGISwapChain1::P resent1 ignore le membre de DXGI_RGBA.

Spécifications

Voir aussi

DXGI_SCALING

IDXGISwapChain1

IDXGISwapChain1::GetBackgroundColor