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


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

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

Этот интерфейс предоставляется всеми входными и выходными контактами.

Диспетчер графов фильтров использует этот интерфейс для подключения контактов и выполнения операций очистки. Приложения могут использовать этот интерфейс для запроса сведений к пин-коду. Приложения никогда не должны вызывать IPin методы, изменяющие состояние контакта, такие как Connect, Disconnect, BeginFlush или EndFlush. Для подключения контактов приложение должно использовать методы в IGraphBuilder.

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

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

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

Методы

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

 
IPin::BeginFlush

Метод BeginFlush начинает операцию очистки. (IPin.BeginFlush)
IPin::Connect

Метод Connect подключает контакт к другому контакту.
IPin::ConnectedTo

Метод ConnectedTo извлекает указатель на подключенный контакт, если таковой имеется.
IPin::ConnectionMediaType

Метод ConnectionMediaType извлекает тип носителя для текущего пин-соединения, если таковой есть.
IPin::D isconnect

Метод Disconnect разрывает текущее закрепление.
IPin::EndFlush

Метод EndFlush завершает операцию очистки. (IPin.EndFlush)
IPin::EndOfStream

Метод EndOfStream уведомляет контакт о том, что дополнительные данные не ожидаются, пока не будет выдана новая команда выполнения для фильтра.
IPin::EnumMediaTypes

Метод EnumMediaTypes перечисляет предпочтительные типы мультимедиа контакта.
IPin::NewSegment

Метод NewSegment уведомляет контакт о том, что образцы мультимедиа, полученные после этого вызова, сгруппированы как сегмент с общим временем начала, временем остановки и скоростью.
IPin::QueryAccept

Метод QueryAccept определяет, принимает ли контакт указанный тип мультимедиа.
IPin::QueryDirection

Метод QueryDirection получает направление контакта (входные или выходные данные).
IPin::QueryId

Метод QueryId получает идентификатор для пин-кода.
IPin::QueryInternalConnections

Метод QueryInternalConnections извлекает контакты, подключенные внутренне к этому контакту (в фильтре).
IPin::QueryPinInfo

Метод QueryPinInfo извлекает сведения о закреплении.
IPin::ReceiveConnection

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

Требования

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