Metodo ID2D1EffectContext::CreateColorContext (d2d1effectauthor.h)

Articolo
02/24/2024

Crea un contesto di colore da uno spazio colore.

Se lo spazio dei colori è Personalizzato, il contesto viene inizializzato dai parametri profile e profileSize .

Se lo spazio dei colori non è Personalizzato, il contesto viene inizializzato con i byte del profilo associati allo spazio dei colori. I parametri profile e profileSize vengono ignorati.

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 usati 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 questo metodo restituisce, contiene l'indirizzo di un puntatore a un nuovo oggetto contesto colore.

Valore restituito

Tipo: HRESULT

Il metodo restituisce un 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 a allocare memoria sufficiente per completare la chiamata.
E_INVALIDARG	Un valore non valido è stato passato al metodo.

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	d2d1effectauthor.h
Libreria	D2d1.lib
DLL	D2d1.dll

Vedi anche

ID2D1EffectContext

Condividi tramite