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