Поделиться через

Метод CBasePin.Inactive

  • Статья

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Метод Inactive уведомляет контакт о том, что фильтр больше не активен.

Синтаксис

virtual HRESULT Inactive();

Параметры

Этот метод не имеет параметров.

Возвращаемое значение

Возвращает S_OK.

Комментарии

Когда фильтр останавливается, класс CBaseFilter вызывает этот метод для всех подключенных контактов фильтра.

Этот метод не выполняет никаких действий в базовом классе. Производные классы должны переопределять этот метод, чтобы освободить все ресурсы, полученные методом CBasePin::Active ; например, чтобы вывести из эксплуатации распределители контактов.

Внутреннее состояние диспетчера графов фильтров не обновляется до тех пор, пока этот метод не вернет, поэтому не проверяйте состояние из этого метода.

Требования

Требование Значение
Заголовок
Amfilter.h (включая Streams.h)
Библиотека
Strmbase.lib (розничные сборки);
Strmbasd.lib (отладочные сборки)

См. также раздел

Класс CBasePin