ID2D1DeviceContext ::CreateColorContextFromFilename, méthode (d2d1_1.h)
Crée un contexte de couleur en le chargeant à partir du nom de fichier spécifié. Les octets de profil sont le contenu du fichier spécifié par Filename.
Syntaxe
HRESULT CreateColorContextFromFilename(
PCWSTR filename,
[out] ID2D1ColorContext **colorContext
);
Paramètres
filename
Type : PCWSTR
Chemin d’accès au fichier contenant les octets de profil à initialiser dans le contexte de couleur.
[out] colorContext
Type : ID2D1ColorContext**
Lorsque cette méthode retourne, contient l’adresse d’un pointeur vers un nouveau 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. 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 couleurs est mis à jour respectivement. Sinon, l’espace est 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 |