Metodo ID2D1DeviceContext::CreateColorContext (d2d1_1.h)

Crea un contesto di colore.

Sintassi

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

Parametri

space

Tipo: D2D1_COLOR_SPACE

Spazio del contesto di colore da creare.

[in, optional] profile

Tipo: const BYTE*

Buffer contenente i byte del profilo ICC utilizzati per inizializzare il contesto del colore quando lo spazio è D2D1_COLOR_SPACE_CUSTOM. Per altri tipi, il parametro viene ignorato e deve essere impostato su NULL.

profileSize

Tipo: UINT32

Dimensioni in byte di Profile.

[out] colorContext

Tipo: ID2D1ColorContext**

Quando termina, questo metodo contiene l'indirizzo di un puntatore a un nuovo oggetto contesto colore.

Valore restituito

Tipo: HRESULT

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

HRESULT	Descrizione
S_OK	Non si sono verificati errori.
E_OUTOFMEMORY	Direct2D non è riuscito ad allocare memoria sufficiente per completare la chiamata.
E_INVALIDARG	Un valore non valido è stato passato al metodo .

Commenti

Il nuovo contesto di colore può essere usato in D2D1_BITMAP_PROPERTIES1 per inizializzare il contesto del colore di una bitmap creata.

Quando lo spazio è D2D1_COLOR_SPACE_CUSTOM, è necessario specificare profile e profileSize . In caso contrario, questi parametri devono essere impostati rispettivamente su NULL e zero. Quando lo spazio è D2D1_COLOR_SPACE_CUSTOM, viene controllato il campo del modello dell'intestazione del profilo per determinare se il profilo è sRGB o scRGB e lo spazio dei colori viene aggiornato rispettivamente. In caso contrario, lo spazio rimane personalizzato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 e aggiornamento della piattaforma per Windows 7 [app desktop | App UWP]
Server minimo supportato	Windows Server 2012 e aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	d2d1_1.h
DLL	D2d1.dll

Vedi anche

D2D1_BITMAP_PROPERTIES1

D2D1_COLOR_SPACE

ID2D1Bitmap1

ID2D1DeviceContext