ID2D1EffectContext::CreateEffect メソッド (d2d1effectauthor.h)

指定したクラス ID の Direct2D 効果を作成します。これは ID2D1DeviceContext::CreateEffect と同じであるため、カスタム効果は他の効果を作成し、変換でラップできます。

構文

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

effectId

型: REFCLSID

効果を作成するための組み込みまたは登録済みの効果 ID。効果 ID の一覧については、「組み込みの効果」を参照してください。

[out] effect

このメソッドが戻るときに、には、効果へのポインターのアドレスが含まれます。

型: 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