ID2D1EffectContext::CreateEffect メソッド (d2d1effectauthor.h)
指定したクラス ID の Direct2D 効果を作成します。 これは ID2D1DeviceContext::CreateEffect と同じであるため、カスタム効果は他の効果を作成し、変換でラップできます。
構文
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 | 指定された効果は、システムによって登録されません。 |
解説
作成された効果は、その効果の作成元の DLL を参照しません。 この効果の読み込み中に呼び出し元が効果の登録を解除した場合、結果の動作は予測できません。
要件
| サポートされている最小のクライアント | Windows 8 および Windows 7 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2012 および Windows Server 2008 R2 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | d2d1effectauthor.h |
| Library | D2D1.lib |