Интерфейс IAMGraphBuilderCallback (strmif.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Интерфейс IAMGraphBuilderCallback предоставляет механизм обратного вызова во время построения графа.
Чтобы использовать этот интерфейс, реализуйте интерфейс в приложении или клиентском объекте. Запросите к диспетчеру графов фильтров интерфейс IObjectWithSite и вызовите метод IObjectWithSite::SetSite с указателем на реализацию интерфейса. Диспетчер графов фильтров вызывает методы в этом интерфейсе при сборке графа, что дает клиенту возможность изменить процесс построения графа.
Основной целью этого интерфейса является настройка фильтра отрисовщика для микширования видео перед подключением. Вы также можете использовать его для отклонения определенного фильтра во время построения графа, например фильтра декодера.
Наследование
Интерфейс IAMGraphBuilderCallback наследуется от интерфейса IUnknown . IAMGraphBuilderCallback также имеет следующие типы элементов:
Методы
Интерфейс IAMGraphBuilderCallback содержит следующие методы.
| IAMGraphBuilderCallback::CreatedFilter Диспетчер графов фильтров вызывает этот метод после создания фильтра, но перед попыткой подключить фильтр. |
| IAMGraphBuilderCallback::SelectedFilter Диспетчер графа фильтра вызывает этот метод, когда находит фильтр-кандидат для графа, но перед созданием фильтра. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | strmif.h (включая Dshow.h) |