Метод CBasePin.CompleteConnect

Статья
07/28/2023

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

Метод CompleteConnect завершает подключение к другому закреплению.

Синтаксис

virtual HRESULT CompleteConnect(
   IPin *pReceivePin
);

Параметры

pReceivePin: Указатель на интерфейс IPin другого контакта.

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

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

Этот метод вызывается для обоих контактов в конце процесса подключения. Соединительная закрепка вызывает его из метода CBasePin::Connect , а получающий пин-код вызывает его из метода CBasePin::ReceiveConnection .

В базовом классе этот метод просто возвращает S_OK. Если производный класс имеет какие-либо требования для завершения соединения, он должен переопределить этот метод. Например, класс CBaseOutputPin использует этот метод для определения выделения памяти.

Если этот метод завершается сбоем, общая попытка подключения также завершается сбоем, и контакт отключается от принимающего пин-кода.

Требования

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

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

Класс CBasePin

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