Метод CPullPin.Connect

Статья
07/28/2023

[Функция, связанная с этой страницей 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

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