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 |