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

Статья
03/13/2024

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

Метод DynamicQueryAccept запрашивает, может ли контакт принимать указанный тип носителя, пока граф работает с текущим подключением к этому контакту.

Синтаксис

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

Параметры

[in] pmt

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

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

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

Код возврата	Описание
S_OK	Тип носителя является допустимым.
VFW_E_TYPE_NOT_ACCEPTED	Тип носителя недопустим.

Приложение или фильтр может вызвать этот метод, чтобы определить, нужно ли перенастроить граф фильтра. Если закрепление может принимать указанный тип носителя, нет необходимости перенастраивать граф.

Хотя метод IPin::QueryAccept также определяет, может ли закрепление принимать тип формата, он не гарантирует, что закрепление может переключиться на этот формат во время выполнения фильтра. Если необходимо переключить форматы во время работы фильтра, вызовите DynamicQueryAccept вместо этого.

Требования

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

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

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

Коды ошибок и успешного выполнения

Интерфейс IPinConnection

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