Интерфейс 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)