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


Интерфейс IPinConnection (strmif.h)

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

Этот интерфейс предоставляет методы для повторного подключения входного контакта во время выполнения фильтра. Диспетчер Graph filter вызывает методы в этом интерфейсе при выполнении динамических переподключений (см. интерфейс IGraphConfig ). Приложения также могут использовать этот интерфейс для выполнения динамического повторного подключения контактов.

Фильтрация разработчиков: Реализуйте этот интерфейс на любом входном контакте, который позволяет динамическое повторное подключение или динамические изменения формата.

Наследование

Интерфейс IPinConnection наследуется от интерфейса IUnknown . IPinConnection также имеет следующие типы элементов:

Методы

Интерфейс IPinConnection содержит следующие методы.

 
IPinConnection::D ynamicDisconnect

Метод DynamicDisconnect отключает закрепление, когда фильтр активен (приостановлен или запущен). Вызовите этот метод вместо IPin::D isconnect, чтобы отключить закрепление при выполнении или приостановке графа.
IPinConnection::D ynamicQueryAccept

Метод DynamicQueryAccept запрашивает, может ли контакт принимать указанный тип носителя, пока граф работает с текущим подключением к этому контакту.
IPinConnection::IsEndPin

Метод IsEndPin указывает, должен ли поиск по повторному подключению заканчиваться этим закреплением.
IPinConnection::NotifyEndOfStream

Метод NotifyEndOfStream запрашивает уведомление от пин-кода при возникновении следующего условия окончания потока.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header strmif.h (включая Dshow.h)

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

Построение динамического графа

Динамическое повторное подключение