Метод IRenderEngine::ConnectFrontEnd

  • Статья

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

Примечание

[Не рекомендуется. Этот API можно удалить из будущих выпусков Windows.]

 

Метод ConnectFrontEnd создает внешний интерфейс графа фильтров из текущего временная шкала.

Синтаксис

HRESULT ConnectFrontEnd();

Параметры

Этот метод не имеет параметров.

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

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

Код возврата Описание
S_OK
 Успешно.
S_WARN_OUTPUTRESET
 Часть графа отрисовки удалена.
E_INVALIDARG
 Для этого обработчика отрисовки не задано временная шкала.
E_MUST_INIT_RENDERER
 Не удалось инициализировать подсистему отрисовки.
E_RENDER_ENGINE_IS_BROKEN
 Операция завершилась сбоем, так как проект не был успешно отрисован.
E_UNEXPECTED
 Непредвиденная ошибка.
VFW_E_INVALIDMEDIATYPE
 Недопустимый тип носителя.

 

Комментарии

Этот метод не создает часть отрисовки графа фильтра. Приложение должно подключить выходные контакты на интерфейсе к нужным фильтрам отрисовки:

  • Для предварительного просмотра вызовите метод IRenderEngine::RenderOutputPins .
  • Чтобы вывести файл, вызовите метод IRenderEngine::GetGroupOutputPin , чтобы получить выходной контакт для каждой группы, а затем подключите контакты к фильтру мультиплексора.

Если вы используете базовый модуль отрисовки, выходные контакты на интерфейсе создают несжатые данные. Если вы используете модуль интеллектуальной отрисовки, выходные контакты создают сжатые данные.

При изменении временная шкала после построения графа фильтра необходимо вызвать ConnectFrontEnd еще раз, чтобы перестроить внешний интерфейс. Метод сохраняет часть графа отрисовки всякий раз, когда это возможно. Однако при добавлении или удалении группы или изменении порядка групп удаляется часть отрисовки, ConnectFrontEnd и приложение должно перестроить ее. Если метод удаляет часть отрисовки, он возвращает S_WARN_OUTPUTRESET.

Примечание

Файл заголовка Qedit.h несовместим с заголовками Direct3D более поздней версии 7.

 

Примечание

Чтобы получить Qedit.h, скачайте обновление Microsoft Windows SDK для Windows Vista и платформа .NET Framework 3.0. Qedit.h недоступен в Microsoft Windows SDK для Windows 7 и платформа .NET Framework 3.5 с пакетом обновления 1 (SP1).

 

Требования

Требование Значение
Заголовок
Qedit.h
Библиотека
Strmiids.lib

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

Интерфейс IRenderEngine

Коды ошибок и успешного выполнения