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 |