Метод CBasePin.TryMediaTypes

Статья
07/28/2023

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

При выборе списка типов TryMediaTypes мультимедиа метод пытается завершить соединение с помощью одного из этих типов.

Синтаксис

virtual HRESULT TryMediaTypes(
         IPin            *pReceivePin,
   const CMediaType      *pmt,
         IEnumMediaTypes *pEnum
);

Параметры

pReceivePin: Указатель на интерфейс IPin принимающего контакта.
Pmt: Указатель на объект CMediaType , ограничивающий возможные типы носителей, или значение NULL.
pEnum: Указатель на интерфейс IEnumMediaTypes , используемый для перечисления списка типов мультимедиа.

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

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

Код возврата	Описание
S_OK	Успешно.
VFW_E_NO_ACCEPTABLE_TYPES	Не удалось найти допустимый тип носителя.

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

Требования

Требование	Значение
Заголовок	Amfilter.h (включая Streams.h)
Библиотека	Strmbase.lib (розничные сборки); Strmbasd.lib (отладочные сборки)

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

Класс CBasePin

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