Método ID2D1DeviceContext::CreateColorContext (d2d1_1.h)
Cria um contexto de cor.
Sintaxe
HRESULT CreateColorContext(
D2D1_COLOR_SPACE space,
[in, optional] const BYTE *profile,
UINT32 profileSize,
[out] ID2D1ColorContext **colorContext
);
Parâmetros
space
Tipo: D2D1_COLOR_SPACE
O espaço do contexto de cor a ser criado.
[in, optional] profile
Tipo: const BYTE*
Um buffer que contém os bytes de perfil ICC usados para inicializar o contexto de cor quando o espaço é D2D1_COLOR_SPACE_CUSTOM. Para outros tipos, o parâmetro é ignorado e deve ser definido como NULL.
profileSize
Tipo: UINT32
O tamanho em bytes de Perfil.
[out] colorContext
Tipo: ID2D1ColorContext**
Quando este método retorna, contém o endereço de um ponteiro para um novo objeto de contexto de cor.
Retornar valor
Tipo: HRESULT
O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.
| HRESULT | Descrição |
|---|---|
| S_OK | Não ocorreu nenhum erro. |
| E_OUTOFMEMORY | Direct2D não pôde alocar memória suficiente para concluir a chamada. |
| E_INVALIDARG | Um valor inválido foi passado para o método . |
Comentários
O novo contexto de cor pode ser usado em D2D1_BITMAP_PROPERTIES1 para inicializar o contexto de cor de um bitmap criado.
Quando o espaço é D2D1_COLOR_SPACE_CUSTOM, profile e profileSize devem ser especificados. Caso contrário, esses parâmetros devem ser definidos como NULL e zero, respectivamente. Quando o espaço é D2D1_COLOR_SPACE_CUSTOM, o campo de modelo do cabeçalho do perfil é inspecionado para determinar se esse perfil é sRGB ou scRGB e o espaço de cor é atualizado, respectivamente. Caso contrário, o espaço permanecerá personalizado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 e Atualização de Plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | d2d1_1.h |
| DLL | D2d1.dll |