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