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

另请参阅

D2D1_BITMAP_PROPERTIES1

D2D1_COLOR_SPACE

ID2D1Bitmap1

ID2D1DeviceContext