Метод IPinConnection::D ynamicDisconnect (strmif.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Метод DynamicDisconnect отключает закрепление, когда фильтр активен (приостановлен или запущен). Вызовите этот метод вместо IPin::D isconnect , чтобы отключить закрепление при выполнении или приостановке графа.
Вызывающий объект должен убедиться, что никакие данные не передаются в контакт при вызове этого метода. Вызовите метод IPinFlowControl::Block для вышестоящий закрепить, чтобы заблокировать поток данных, или используйте другой механизм, чтобы убедиться, что образцы не будут доставлены до тех пор, пока этот контакт не будет повторно подключен.
Синтаксис
HRESULT DynamicDisconnect();
Возвращаемое значение
Возвращает значение HRESULT . Ниже приведены возможные значения.
| Код возврата | Описание |
|---|---|
|
Закрепление уже отключено. |
|
Успешно. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | strmif.h (включая Dshow.h) |
| Библиотека | Strmiids.lib |
См. также раздел
Динамическое повторное подключение