Метод ID2D1Factory1::GetRegisteredEffects (d2d1_1.h)
Возвращает идентификаторы классов зарегистрированных в настоящее время эффектов и глобальных эффектов для этой фабрики.
Синтаксис
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. |
Комментарии
Набор идентификаторов классов будет атомарно возвращен API. Набор не будет прерываться другими потоками, регистрирующими или отменяющими регистрацию эффектами.
Если значение effectsRegistered больше, чем effectCount, предоставленный массив по-прежнему будет заполнен до емкости с текущим набором зарегистрированных эффектов. Этот метод возвращает идентификаторы CLSID для всех глобальных эффектов и всех эффектов, зарегистрированных в этой фабрике.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 и обновление платформы для Windows 7 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | d2d1_1.h |
| Библиотека | D2d1.lib |
| DLL | D2d1.dll |