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 |