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

Метод CPullPin.Connect

  • Статья

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

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

Синтаксис

HRESULT Connect(
   IUnknown      *pUnk,
   IMemAllocator *pAlloc,
   BOOL          bSync
);

Параметры

Панк

Указатель на интерфейс IUnknown выходного контакта.

pAlloc

Указатель на интерфейс IMemAllocator предпочтительного распределителя входного контакта или NULL.

bSync

Логическое значение, указывающее, следует ли использовать синхронные операции чтения. Если задано значение TRUE, контакт выполняет синхронные операции чтения в выходном контакте. Если задано значение FALSE, контакт выполняет асинхронные запросы на чтение.

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

Возвращает HRESULT. Ниже приведены возможные значения.

Код возврата Описание
S_OK
 Успешно.
VFW_E_ALREADY_CONNECTED
 Контакт ввода уже подключен.
E_NOINTERFACE
 Выходной контакт не предоставляет доступ к IAsyncReader.

Комментарии

Вызовите этот метод во время процесса подключения входного ПИН-кода. Если метод завершается сбоем, контакт должен завершиться ошибкой подключения.

Этот метод запрашивает выходной контакт для интерфейса IAsyncReader . В случае успешного выполнения он вызывает CPullPin::D ecideAllocator для согласования распределителя для подключения. Если входной пин-код имеет предпочтительный распределитель, укажите его в параметре pAlloc ; Метод DecideAllocator передает этот указатель методу IAsyncReader::RequestAllocator выходного контакта. В противном случае задайте для pAllocзначение NULL.

Если значение bSync равно TRUE, объект CPullPin выполняет синхронные запросы на чтение, вызывая IAsyncReader::SyncReadAligned выходного пин-кода. В противном случае он вызывает метод IAsyncReader::Request для выполнения перекрывающихся запросов на чтение.

Требования

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

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

Класс CPullPin