ID2D1DeviceContext：：CreateColorContextFromFilename 方法 (d2d1_1.h)

通过从指定的文件名加载颜色上下文来创建颜色上下文。 配置文件字节是 文件名指定的文件的内容。

语法

HRESULT CreateColorContextFromFilename(
        PCWSTR            filename,
  [out] ID2D1ColorContext **colorContext
);

参数

filename

类型： PCWSTR

包含用于初始化颜色上下文的配置文件字节的文件的路径。

[out] colorContext

类型： ID2D1ColorContext**

此方法返回时，包含指向新颜色上下文的指针的地址。

返回值

类型： HRESULT

该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

HRESULT	说明
S_OK	未发生错误。
E_OUTOFMEMORY	Direct2D 无法分配足够的内存来完成调用。
E_INVALIDARG	传递给 方法的值无效。

注解

可以在 D2D1_BITMAP_PROPERTIES1 中使用新的颜色上下文来初始化创建的位图的颜色上下文。 检查配置文件标头的模型字段以确定此配置文件是 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

ID2D1Bitmap1

ID2D1DeviceContext