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

另請參閱

D2D1_BITMAP_PROPERTIES1

ID2D1Bitmap1

ID2D1DeviceContext