Метод IPin::QueryAccept (strmif.h)

  • Статья

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

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

Синтаксис

HRESULT QueryAccept(
  [in] const AM_MEDIA_TYPE *pmt
);

Параметры

[in] pmt

Указатель на структуру AM_MEDIA_TYPE , указывающую тип носителя.

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

Возвращает одно из следующих значений:

Код возврата Описание
S_FALSE
 Закрепление отклоняет тип носителя.
S_OK
 Закрепление принимает тип носителя.

Комментарии

Возвращаемое значение S_OK указывает, что контакт будет принимать тип носителя либо в следующем образце, либо после повторного подключения контакта. Реализация должна учитывать текущее состояние фильтра, включая подключения на других контактах, а также любые свойства, которые можно задать для фильтра.

Любое другое возвращаемое значение, включая S_FALSE, означает, что закрепление отклоняет тип носителя. Поэтому протестируйте S_OK явным образом; не используйте макрос SUCCEEDED .

Если фильтр выполняется, возвращаемое значение S_OK является неоднозначным. Закрепление может принять изменение формата в следующем примере мультимедиа без повторного подключения; или может потребоваться повторное подключение. Если контакт поддерживает интерфейс IPinConnection , вызовите метод IPinConnection::D ynamicQueryAccept , который, в частности, проверяет, может ли контакт принять новый тип без повторного подключения.

Требования

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

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

Поток данных в графе фильтров

Изменения динамического формата

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

Интерфейс IPin