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

Voir aussi

D2D1_BITMAP_PROPERTIES1

ID2D1Bitmap1

ID2D1DeviceContext