Método ID2D1DeviceContext::CreateColorContext (d2d1_1.h)

Crea un contexto de color.

Sintaxis

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

Parámetros

space

Tipo: D2D1_COLOR_SPACE

Espacio de contexto de color que se va a crear.

[in, optional] profile

Tipo: const BYTE*

Búfer que contiene los bytes de perfil ICC usados para inicializar el contexto de color cuando se D2D1_COLOR_SPACE_CUSTOMespacio. Para otros tipos, el parámetro se omite y debe establecerse en NULL.

profileSize

Tipo: UINT32

Tamaño en bytes del perfil.

[out] colorContext

Tipo: ID2D1ColorContext**

Cuando este método vuelve, contiene la dirección de un puntero a un nuevo objeto de contexto de color.

Valor devuelto

Tipo: HRESULT

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

HRESULT	Descripción
S_OK	No se ha producido ningún error.
E_OUTOFMEMORY	Direct2D no pudo asignar suficiente memoria para completar la llamada.
E_INVALIDARG	Se pasó un valor no válido al método .

Comentarios

El nuevo contexto de color se puede usar en D2D1_BITMAP_PROPERTIES1 para inicializar el contexto de color de un mapa de bits creado.

Cuando se D2D1_COLOR_SPACE_CUSTOMespacio, se debe especificar profileSize y profileSize. De lo contrario, estos parámetros deben establecerse en NULL y cero respectivamente. Cuando el espacio es D2D1_COLOR_SPACE_CUSTOM, se inspecciona el campo de modelo del encabezado de perfil para determinar si este perfil es sRGB o scRGB y el espacio de colores se actualiza respectivamente. De lo contrario, el espacio permanece personalizado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	d2d1_1.h
Archivo DLL	D2d1.dll

Consulte también

D2D1_BITMAP_PROPERTIES1

D2D1_COLOR_SPACE

ID2D1Bitmap1

ID2D1DeviceContext