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


Метод IPinConnection::IsEndPin (strmif.h)

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

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

Синтаксис

HRESULT IsEndPin();

Возвращаемое значение

Возвращает значение HRESULT . Ниже приведены возможные значения.

Код возврата Описание
S_FALSE
Этот контакт не является кандидатом для повторного подключения. (Поиск повторного подключения не должен останавливаться на этом контакте.)
S_OK
Этот контакт является кандидатом для повторного подключения. (Поиск повторного подключения должен остановиться на этом контакте.)

Комментарии

Фильтр или приложение может вызвать этот метод, чтобы определить, является ли контакт кандидатом на динамическое повторное подключение.

Как правило, фильтр приемника или фильтр, который разделяет или объединяет данные, должны возвращать S_OK. Другие фильтры (например, простые фильтры преобразования) должны возвращать S_FALSE.

Требования

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

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

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

Коды ошибок и успешности

Интерфейс IPinConnection