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

Метод IFilterGraph3::SetSyncSourceEx (strmif.h)

  • Статья

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

Метод SetSyncSourceEx устанавливает два эталонных часа для графа фильтра: основные часы, используемые большинством фильтров, и вторичные часы, используемые только одним указанным фильтром.

Синтаксис

HRESULT SetSyncSourceEx(
  [in] IReferenceClock *pClockForMostOfFilterGraph,
  [in] IReferenceClock *pClockForFilter,
  [in] IBaseFilter     *pFilter
);

Параметры

[in] pClockForMostOfFilterGraph

Указатель на интерфейс IReferenceClock main ссылочных часов. Каждый фильтр в графе использует эти часы, за исключением фильтра, указанного параметром pFilter .

[in] pClockForFilter

Указатель на интерфейс IReferenceClock вторичных часов. Фильтр, заданный параметром pFilter, использует эти часы.

[in] pFilter

Указатель на интерфейс IBaseFilter фильтра в графе. Этот фильтр использует вторичные ссылочные часы.

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

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

Код возврата Описание
S_OK
 Успешно.
VFW_E_NOT_STOPPED
 Граф фильтра не остановлен.

Комментарии

Если граф фильтра запущен или приостановлен, этот метод возвращает VFW_E_NOT_STOPPED.

Чтобы очистить обе ссылочные часы, задайте для всех трех параметров значение NULL. Чтобы задать один час для всего графа без дополнительных часов, вызовите метод IMediaFilter::SetSyncSource в диспетчере фильтров графов.

Требования

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

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

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

Интерфейс IFilterGraph3