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

Метод IRenderEngine::SetFilterGraph

  • Статья

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

Примечание

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

 

Метод SetFilterGraph задает граф фильтра для используемого обработчика отрисовки.

Синтаксис

HRESULT SetFilterGraph(
   IGraphBuilder *pFG
);

Параметры

Pfg

Указатель на интерфейс IGraphBuilder графа фильтра.

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

Возвращает одно из следующих значений HRESULT :

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

 

Комментарии

Большинству приложений не требуется вызывать этот метод. Обычно подсистема отрисовки создает граф, вызывая метод IRenderEngine::ConnectFrontEnd .

Этот метод завершается ошибкой, если подсистема отрисовки уже имеет граф фильтра.

Никогда не извлекайте указатель на граф фильтра, созданный одним обработчиком отрисовки, и не используйте его в качестве параметра этого метода в другом обработчике отрисовки. Это приведет к непредсказуемым результатам.

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

Примечание

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

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