Метод IMFMediaEngineEx::InsertAudioEffect (mfmediaengine.h)

  • Статья

Вставляет звуковой эффект.

Синтаксис

HRESULT InsertAudioEffect(
  [in] IUnknown *pEffect,
  [in] BOOL     fOptional
);

Параметры

[in] pEffect

Это может быть:

  • Указатель на интерфейс IMFTransform преобразования Media Foundation (MFT), реализующего звуковой эффект.
  • Указатель на интерфейс IMFActivate объекта активации. Объект активации должен создать MFT для звукового эффекта.

[in] fOptional

Указывает, является ли эффект необязательным.

Значение Значение
ИСТИННЫЙ
 Эффект необязателен. Если обработчик мультимедиа не может добавить эффект, он игнорирует его и продолжает воспроизведение.
ЛОЖНЫХ
 Эффект является обязательным. Если объект обработчика мультимедиа не может добавить эффект, возникает ошибка воспроизведения.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Успешно.
MF_E_INVALIDREQUEST
 Достигнуто максимальное количество звуковых эффектов.

Комментарии

Эффект применяется при загрузке следующего ресурса мультимедиа.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header mfmediaengine.h

См. также раздел

IMFMediaEngineEx