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 |