Метод IAMGraphBuilderCallback::CreatedFilter (strmif.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]
Диспетчер графов фильтров вызывает этот метод после создания фильтра, но перед попыткой подключения фильтра.
Синтаксис
HRESULT CreatedFilter(
IBaseFilter *pFil
);
Параметры
pFil
Указатель на интерфейс IBaseFilter фильтра.
Возвращаемое значение
Если метод возвращает код успешного выполнения, диспетчер фильтров graph пытается подключить фильтр. Если метод возвращает код сбоя, диспетчер фильтров графа отклоняет фильтр.
Комментарии
Этот метод позволяет клиенту настроить фильтр сразу после его создания. Отрисовщик для микширования видео — это основной пример фильтра, который требует настройки перед подключением. Большинство других фильтров DirectShow можно настроить после подключения.
Диспетчер фильтров графов содержит критически важный раздел на уровне графа во время вызова этого метода. Поэтому метод обратного вызова не должен вызывать методы в диспетчере фильтров графов или любые методы в фильтрах, которые могут изменить состояние графа (например, отключение контактов). Это может привести к взаимоблокировкам или другим непредвиденным событиям.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | strmif.h (включая Dshow.h) |
| Библиотека | Strmiids.lib |