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

Метод IRenderEngine::RenderOutputPins

  • Статья

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

Примечание

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

 

Метод RenderOutputPins создает часть графа фильтра для предварительного просмотра.

Синтаксис

HRESULT RenderOutputPins();

Параметры

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

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

Возвращает значения HRESULT . Возможные следующие значения.

Код возврата Описание
S_OK
 Успешно.
VFW_S_AUDIO_NOT_RENDERED
 Не удается воспроизвести аудиопоток.
E_INVALIDARG
 Недопустимый аргумент.
E_RENDER_ENGINE_IS_BROKEN
 Операция завершилась сбоем, так как проект не был успешно отрисован.
E_UNEXPECTED
 Непредвиденная ошибка.

 

Комментарии

Перед вызовом этого метода вызовите IRenderEngine::ConnectFrontEnd , чтобы создать внешний интерфейс графа. Для выполнения операции, отличной от предварительного просмотра, не вызывайте этот метод. Вместо этого вызовите IRenderEngine::GetGroupOutputPin , чтобы получить указатели на выходные контакты.

Если на компьютере пользователя нет карта звука, этот метод возвращает VFW_S_AUDIO_NOT_RENDERED. В этом случае не будет предварительного просмотра звука, но предварительный просмотр видео не затрагивается.

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

Примечание

Файл заголовка 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

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