ID2D1EffectContext：：CreateColorContext 方法 (d2d1effectauthor.h)

  • 發行項

從色彩空間建立色彩內容。

如果色彩空間是 Custom，則會從 配置檔 和 profileSize 參數初始化內容。

如果色彩空間不是 [自定義]，則會使用與色彩空間相關聯的配置檔位元組來初始化內容。 會忽略配置檔和 profileSize 參數。

語法

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 無效的值已傳遞至 方法。

規格需求

需求 值
最低支援的用戶端 適用於 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 適用於 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 d2d1effectauthor.h
程式庫 D2d1.lib
Dll D2d1.dll

另請參閱

ID2D1EffectContext