Интерфейс IGraphBuilder (strmif.h)

  • Статья

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

Этот интерфейс предоставляет методы, позволяющие приложению создавать граф фильтра. Диспетчер фильтров графов реализует этот интерфейс.

Интерфейс IGraphBuilder наследуется от интерфейса IFilterGraph . IFilterGraph предоставляет базовые операции, такие как добавление фильтра к графу или соединение двух контактов. IGraphBuilder добавляет дополнительные методы, которые создают графы на основе частичной информации. Например, метод IGraphBuilder::RenderFile создает граф для воспроизведения файлов с учетом имени файла. Метод IGraphBuilder::Render отрисовывает данные из выходного контакта, подключая к контакту новые фильтры.

Используя эти методы, приложению не нужно указывать все фильтры и соединения закрепления в графе. Вместо этого диспетчер фильтров графов выбирает фильтры, зарегистрированные в системе пользователя, добавляет их в граф и подключает их. Дополнительные сведения см. в разделе Intelligent Connect.

Наследование

Интерфейс IGraphBuilder наследуется от IFilterGraph. IGraphBuilder также имеет следующие типы элементов:

Методы

Интерфейс IGraphBuilder содержит следующие методы.

 
IGraphBuilder::Abort

Метод Abort запрашивает диспетчер фильтров Graph, чтобы как можно быстрее остановить текущую задачу.
IGraphBuilder::AddSourceFilter

Метод AddSourceFilter добавляет фильтр источника для указанного файла в граф фильтра.
IGraphBuilder::Connect

Метод Connect соединяет два контакта, используя при необходимости промежуточные.
IGraphBuilder::Render

Метод Render создает граф фильтра, который отрисовывает данные из указанного выходного контакта.
IGraphBuilder::RenderFile

Метод RenderFile создает граф фильтра, который отрисовывает указанный файл. (IGraphBuilder.RenderFile)
IGraphBuilder::SetLogFile

Метод SetLogFile задает файл для действий ведения журнала, выполняемых при попытке выполнения операции.
IGraphBuilder::ShouldOperationContinue

Метод ShouldOperationContinue запрашивает, следует ли продолжить текущую операцию.

Требования

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

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

IFilterGraph

Интерфейсы