ID2D1DeviceContext::CreateColorContext 方法 (d2d1_1.h)
创建颜色上下文。
语法
HRESULT CreateColorContext(
D2D1_COLOR_SPACE space,
[in, optional] const BYTE *profile,
UINT32 profileSize,
[out] ID2D1ColorContext **colorContext
);
参数
space
类型: D2D1_COLOR_SPACE
要创建的颜色上下文的空间。
[in, optional] profile
类型: const BYTE*
一个缓冲区,其中包含用于在D2D1_COLOR_SPACE_CUSTOM空间时初始化颜色上下文的 ICC 配置文件字节。 对于其他类型,参数将被忽略,应设置为 NULL。
profileSize
类型: UINT32
Profile 的大小(以字节为单位)。
[out] colorContext
类型: ID2D1ColorContext**
此方法返回时,包含指向新颜色上下文对象的指针的地址。
返回值
类型: HRESULT
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
HRESULT | 说明 |
---|---|
S_OK | 未发生错误。 |
E_OUTOFMEMORY | Direct2D 无法分配足够的内存来完成调用。 |
E_INVALIDARG | 传递给方法的值无效。 |
注解
可以在 D2D1_BITMAP_PROPERTIES1 中使用新的颜色上下文来初始化已创建位图的颜色上下文。
D2D1_COLOR_SPACE_CUSTOM空间时,必须指定 profile 和 profileSize。 否则,这些参数应分别设置为 NULL 和零。 当空间D2D1_COLOR_SPACE_CUSTOM时,将检查配置文件标头的模型字段,以确定此配置文件是 sRGB 还是 scRGB,并分别更新颜色空间。 否则,空间仍为自定义空间。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 适用于 Windows 7 的Windows 8和平台更新 [桌面应用 |UWP 应用] |
最低受支持的服务器 | 适用于 Windows Server 2008 R2 的Windows Server 2012和平台更新 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | d2d1_1.h |
DLL | D2d1.dll |