ID2D1DeviceContext::CreateEffect メソッド (d2d1_1.h)

指定したクラス ID の効果を作成します。

構文

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	指定された効果はシステムによって登録されません。
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