Метод IPin::Connect (strmif.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Метод Connect
подключает контакт к другому контакту.
Приложения не должны вызывать этот метод. Вместо этого используйте методы IGraphBuilder . Этот метод вызывается диспетчером фильтров Graph для подключения контактов.
Синтаксис
HRESULT Connect(
[in] IPin *pReceivePin,
[in] const AM_MEDIA_TYPE *pmt
);
Параметры
[in] pReceivePin
Указатель на интерфейс IPin принимающего контакта.
[in] pmt
Указатель на структуру AM_MEDIA_TYPE , указывающую тип носителя для соединения. Может иметь значение NULL.
Возвращаемое значение
Возвращает значение HRESULT . Ниже приведены возможные значения.
Код возврата | Описание |
---|---|
|
Успешно. |
|
Закрепление уже подключено. |
|
Не удается найти допустимый тип носителя. |
|
Контакты не могут согласовать транспорт или нет распределителя для подключения. |
|
Фильтр активен, а закрепление не поддерживает динамическое повторное подключение. |
|
Указанный тип носителя недопустим. |
Комментарии
Параметр pmt может иметь значение NULL. Он также может указать частичный тип носителя со значением GUID_NULL для основного типа, подтипа или формата.
Этот метод проверяет возможность подключения. Если закрепление отклоняет подключение, метод завершается ошибкой. Соединительная закрепка предлагает типы мультимедиа путем вызова IPin::ReceiveConnection в принимающем контакте.
Требования
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | strmif.h (включая Dshow.h) |
Библиотека | Strmiids.lib |