ID2D1EffectContext ::CreateColorContext, méthode (d2d1effectauthor.h)

Crée un contexte de couleur à partir d’un espace de couleurs.

Si l’espace de couleur est Personnalisé, le contexte est initialisé à partir des paramètres profile et profileSize .

Si l’espace de couleurs n’est pas Personnalisé, le contexte est initialisé avec les octets de profil associés à l’espace de couleur. Les paramètres profile et profileSize sont ignorés.

Syntaxe

HRESULT CreateColorContext(
                 D2D1_COLOR_SPACE  space,
  [in, optional] const BYTE        *profile,
                 UINT32            profileSize,
  [out]          ID2D1ColorContext **colorContext
);

Paramètres

space

Type : D2D1_COLOR_SPACE

Espace du contexte de couleur à créer.

[in, optional] profile

Type : const BYTE*

Mémoire tampon contenant les octets de profil ICC utilisés pour initialiser le contexte de couleur lorsque l’espace est D2D1_COLOR_SPACE_CUSTOM. Pour les autres types, le paramètre est ignoré et doit être défini sur NULL.

profileSize

Type : UINT32

Taille en octets de Profil.

[out] colorContext

Type : ID2D1ColorContext**

Lorsque cette méthode retourne, contient l’adresse d’un pointeur vers un nouvel objet de contexte de couleur.

Valeur retournée

Type : HRESULT

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

HRESULT	Description
S_OK	Aucune erreur ne s'est produite.
E_OUTOFMEMORY	Direct2D n’a pas pu allouer suffisamment de mémoire pour terminer l’appel.
E_INVALIDARG	Une valeur non valide a été passée à la méthode.

Configuration requise

Condition requise	Valeur
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 mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	d2d1effectauthor.h
Bibliothèque	D2d1.lib
DLL	D2d1.dll

Voir aussi

ID2D1EffectContext