Интерфейс 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) |