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

Метод CBasePin.BreakConnect

  • Статья

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

Метод BreakConnect освобождает контакт из соединения.

Синтаксис

virtual HRESULT BreakConnect();

Параметры

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

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

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

Комментарии

Этот метод вызывается во время отключения контактов методом CBasePin::D isconnect . Он также вызывается во время попытки подключения, если метод CBasePin::CheckConnect завершается сбоем.

Этот метод должен освободить все ресурсы, полученные с помощью метода CheckConnect . Например, если CheckConnect выделяет память, BreakConnect она должна освободиться. Если CheckConnect запрашивает соединительный контакт для интерфейса, BreakConnect должен освободить интерфейс.

Обратите внимание, что BreakConnect может вызываться без соответствующего вызова CompleteConnect. Поэтому нельзя предположить, что ранее был вызван метод CompleteConnect .

Требования

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

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

Класс CBasePin