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