次の方法で共有


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

関連項目

エフェクト

ID2D1DeviceContext

ID2D1Effect

ID2D1Factory1::RegisterEffect