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

  • Article

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.

Note Comme toutes les données de présentation, nous vous recommandons d’effectuer des opérations à virgule flottante dans un espace de couleurs linéaire. Lorsque le bureau est en mode de profondeur de couleur de bits fixe, le système d’exploitation convertit les données de couleur linéaires en données RVB standard (sRGB, espace corrigé gamma 2.2) pour composer à l’écran. Pour plus d’informations, consultez Conversion de données pour l’espace colorimétrique.
 

Spécifications

   
Client minimal pris en charge Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 et Platform Update pour Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête dxgi1_2.h
Bibliothèque Dxgi.lib

Voir aussi

DXGI_SCALING

IDXGISwapChain1

IDXGISwapChain1::GetBackgroundColor