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

このファクトリで現在登録されている効果とグローバル効果のクラス ID を返します。

構文

HRESULT GetRegisteredEffects(
  [out]           CLSID  *effects,
                  UINT32 effectsCount,
  [out]           UINT32 *effectsReturned,
  [out, optional] UINT32 *effectsRegistered
);

パラメーター

[out] effects

型: CLSID*

このメソッドが戻るときに、 には効果の配列が含まれます。 効果が取得されない場合は NULL。

effectsCount

型: UINT32

効果配列の容量。

[out] effectsReturned

型: UINT32*

このメソッドから制御が戻るときに、効果にコピーされた効果の 数が格納されます。

[out, optional] effectsRegistered

型: UINT32*

このメソッドから制御が戻るときに、システムに現在登録されている効果の数が格納されます。

戻り値

型: HRESULT

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

HRESULT	説明
S_OK	エラーは発生していません。
E_OUTOFMEMORY	Direct2D は、呼び出しを完了するのに十分なメモリを割り当てませんでした。
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	effectsRegistered が effectCount より大きい。

注釈

クラス ID のセットは、API によってアトミックに返されます。 セットは、他のスレッドによる影響の登録または登録解除によって中断されることはありません。

effectsRegistered が effectCount より大きい場合でも、指定された配列は、現在の登録済み効果のセットで容量に入力されます。 このメソッドは、このファクトリに登録されているすべてのグローバル効果とすべての効果の CLSID を返します。

要件

要件	値
サポートされている最小のクライアント	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::RegisterEffect