共用方式為


ID2D1DeviceCoNtext::CreateEffect 方法 (d2d1_1.h)

為指定的類別識別碼建立效果。

語法

HRESULT CreateEffect(
        REFCLSID    effectId,
  [out] ID2D1Effect **effect
);

參數

effectId

類型: REFCLSID

要建立之效果的類別識別碼。 如需效果識別碼的清單,請參閱 內建效果

[out] effect

類型: ID2D1Effect**

當這個方法傳回時,會包含新效果指標的位址。

傳回值

類型: HRESULT

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

HRESULT 描述
S_OK 未發生任何錯誤。
E_OUTOFMEMORY Direct2D 無法配置足夠的記憶體來完成呼叫。
E_INVALIDARG 不正確值已傳遞至 方法。
D3DERR_OUTOFVIDEOMEMORY Direct3D 沒有足夠的顯示記憶體來執行作業。
D2DERR_EFFECT_IS_NOT_REGISTERED 系統不會註冊指定的效果。
E_NOTFOUND 未註冊效果的其他可能 HRESULT (,例如 D2DERR_EFFECT_IS_NOT_REGISTERED) 。
D2DERR_INSUFFICIENT_DEVICE_CAPABILITIES 效果需要 D2D 裝置不支援的功能。

備註

如果建立的效果是在 DLL 中實作的自訂效果,這不會遞增該 DLL 的參考計數。 如果應用程式在載入該效果時刪除效果,則產生的行為無法預測。

規格需求

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

另請參閱

效果

ID2D1DeviceCoNtext

ID2D1Effect

ID2D1Factory1::RegisterEffect