Метод IDistributorNotify::NotifyGraphChange (strmif.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Метод NotifyGraphChange вызывается при изменении набора фильтров в графе фильтров или при изменении соединений с закреплением.
Синтаксис
HRESULT NotifyGraphChange();
Возвращаемое значение
Возвращает значение HRESULT .
Комментарии
Этот метод вызывается всякий раз, когда вызывается метод IFilterGraph::AddFilter, IFilterGraph::RemoveFilter или IFilterGraph::ConnectDirect или вызывается метод, который приводит к вызову одного из них (например , IGraphBuilder::RenderFile).
Убедитесь, что вы вызываете Release для всех сохраненных фильтров, которые были удалены на этом этапе. Из соображений производительности PID могут не выполнять повторное сканирование фильтров, пока идентификаторам не потребуются интерфейсы, так как может быть отправлено несколько отдельных уведомлений. Однако важно немедленно освободить все кэшированные интерфейсы.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | strmif.h (включая Dshow.h) |
| Библиотека | Strmiids.lib |