ID2D1DeviceContext::CreateEffect メソッド (d2d1_1.h)
指定したクラス ID の効果を作成します。
構文
HRESULT CreateEffect(
REFCLSID effectId,
[out] ID2D1Effect **effect
);
パラメーター
effectId
型: REFCLSID
作成する効果のクラス ID。 効果 ID の一覧については、「 組み込みの 効果」を参照してください。
[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 8 および Windows 7 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2012 および Windows Server 2008 R2 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | d2d1_1.h |
| [DLL] | D2d1.dll |