Метод IConfigAviMux::SetMasterStream (strmif.h)

Статья
07/28/2023

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Метод SetMasterStream задает поток, который будет использоваться для синхронизации других потоков в файле.

Синтаксис

HRESULT SetMasterStream(
  [in] LONG iStream
);

Параметры

[in] iStream

Указывает индекс потока или –1, чтобы указать, что поток не master. Мультиплекс AVI записывает по одному потоку для каждого подключенного контактного ввода. Stream числа индексируются с нуля.

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

Возвращает значение HRESULT . Ниже приведены возможные значения.

Код возврата	Описание
E_INVALIDARG	Недопустимый аргумент.
S_OK	Успешно.

Если вы собираете звук и видео из двух разных источников, используйте этот метод для синхронизации потоков. Потоки, поступающие из отдельных источников записи, могут записываться с немного разными скоростями. Если указать master поток, мультиплекс AVI корректирует скорость воспроизведения для других потоков, чтобы компенсировать любое смещение, которое может произойти.

Рекомендуется использовать аудиопоток в качестве потока master, так как незначительные изменения скорости воспроизведения видео менее заметны, чем изменения скорости воспроизведения звука. Кроме того, изменение скорости воспроизведения звука приведет к повторной выборке звука с помощью звукового драйвера.

Этот метод работает путем настройки значений dwScale и dwRate в структуре AVISTREAMHEADER .

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	strmif.h (включая Dshow.h)
Библиотека	Strmiids.lib

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

Справочник по RIFF-файлу AVI

Коды ошибок и успешности

Интерфейс IConfigAviMux

Поделиться через