Compartilhar via


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

Confira também

D2D1_BITMAP_PROPERTIES1

D2D1_COLOR_SPACE

ID2D1Bitmap1

ID2D1DeviceContext