Функция MFCreateAudioRendererActivate (mfidl.h)

Статья
03/05/2024

Создает объект активации для отрисовщика потоковой передачи звука.

Синтаксис

HRESULT MFCreateAudioRendererActivate(
  [out] IMFActivate **ppActivate
);

Параметры

[out] ppActivate

Получает указатель на интерфейс IMFActivate . Используйте этот интерфейс для создания отрисовщика звука. Вызывающий объект должен освободить интерфейс .

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

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Примечание Чтобы избежать утечки памяти, вызовите IMFActivate::ShutdownObject перед освобождением окончательной ссылки на отрисовщик звука или активируемый объект отрисовщика звука.

Чтобы настроить отрисовщик звука, задайте любой из следующих атрибутов в объекте IMFActivate перед вызовом ActivateObject. (Если вы используете сеанс мультимедиа, сеанс мультимедиа автоматически вызывает ActivateObject при постановке топологии в очередь.)

attribute	Описание
MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ID	Идентификатор устройства конечной точки аудио.
MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ROLE	Роль конечной точки звука.
MF_AUDIO_RENDERER_ATTRIBUTE_FLAGS	Прочие флаги конфигурации.
MF_AUDIO_RENDERER_ATTRIBUTE_SESSION_ID	Класс политики звука.
MF_AUDIO_RENDERER_ATTRIBUTE_STREAM_CATEGORY	Категория аудиопотока.
MF_LOW_LATENCY	Включает потоковую передачу звука с низкой задержкой.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	mfidl.h
Библиотека	Mf.lib
DLL	Mf.dll

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

Объекты активации

Функции Media Foundation

Отрисовщик потоковой передачи звука

Share via