ID2D1DeviceContext ::CreateColorContext, méthode (d2d1_1.h)
Crée un contexte de couleur.
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. |
Remarques
Le nouveau contexte de couleur peut être utilisé dans D2D1_BITMAP_PROPERTIES1 pour initialiser le contexte de couleur d’une image bitmap créée.
Lorsque l’espace est D2D1_COLOR_SPACE_CUSTOM, le profil et le profilSize doivent être spécifiés. Sinon, ces paramètres doivent être définis sur NULL et zéro respectivement. Lorsque l’espace est D2D1_COLOR_SPACE_CUSTOM, le champ modèle de l’en-tête de profil est inspecté pour déterminer si ce profil est sRGB ou scRGB et si l’espace de couleur est mis à jour respectivement. Sinon, l’espace reste personnalisé.
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 | d2d1_1.h |
| DLL | D2d1.dll |