ID2D1DeviceContext::CreateColorContextFromFilename 方法 (d2d1_1.h)
從指定的檔名載入色彩內容,以建立色彩內容。 配置檔位元組是 Filename 所指定的檔案內容。
語法
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 |