ID2D1Factory1::GetEffectProperties メソッド (d2d1_1.h)

効果のプロパティを取得します。

構文

HRESULT GetEffectProperties(
  [in]  REFCLSID        effectId,
  [out] ID2D1Properties **properties
);

パラメーター

[in] effectId

型: REFCLSID

プロパティを取得する効果の ID。

[out] properties

種類: ID2D1Properties**

このメソッドが戻るときに、 には、効果のメタデータのクエリに使用できるプロパティ インターフェイスへのポインターのアドレスが含まれます。

戻り値

型: HRESULT

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

HRESULT 説明
S_OK エラーは発生していません。
D2DERR_EFFECT_IS_NOT_REGISTERED 要求された効果が見つかりませんでした。
E_OUTOFMEMORY Direct2D は、呼び出しを完了するのに十分なメモリを割り当てませんでした。

注釈

返される効果プロパティには、効果のすべての変更可能なプロパティが既定値の NULL または空の値に設定されます。

  • 値型は 0 で塗りつぶされます。
  • BLOB 型と文字列型は長さ 0 になります。
  • 配列型の長さは 1 で、配列の要素は前の規則に準拠します。
このメソッドを使用して、 ID2D1DeviceContext::CreateEffect に表示されない効果のプロパティを返すことはできません。

要件

要件
サポートされている最小のクライアント Windows 7 のWindows 8とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 のWindows Server 2012とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー d2d1_1.h
Library D2d1.lib
[DLL] D2d1.dll

こちらもご覧ください

ID2D1Factory1

ID2D1Factory1::GetRegisteredEffects

ID2D1Factory1::RegisterEffect