Метод ICaptureGraphBuilder::SetFiltergraph (strmif.h)

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

Примечание Интерфейс ICaptureGraphBuilder не рекомендуется использовать. Вместо этого используйте ICaptureGraphBuilder2 .

 

Сообщает объекту построителя графов, какой граф фильтра использовать.

Синтаксис

HRESULT SetFiltergraph(
  [in] IGraphBuilder *pfg
);

Параметры

[in] pfg

Указатель на интерфейс IGraphBuilder , указывающий граф фильтра для последующих вызовов метода IFilterGraph::AddFilter .

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

Возвращает значение HRESULT .

Комментарии

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

Требования

Требование	Значение
Целевая платформа	Windows
Header	strmif.h (включая Dshow.h)

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

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

Интерфейс ICaptureGraphBuilder