Метод CBasePin.SetMediaType

Статья
07/28/2023

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

Метод SetMediaType задает тип носителя для соединения.

Синтаксис

virtual HRESULT SetMediaType(
   const CMediaType *pmt
);

Параметры

Pmt: Указатель на объект CMediaType , указывающий тип носителя.

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

Возвращает S_OK.

Этот метод устанавливает формат для соединения с закреплением. Перед вызовом этого метода пин-код вызывает метод CBasePin::CheckMediaType , чтобы определить, является ли тип носителя допустимым. Таким образом, предполагается, что параметр pmt является допустимым типом носителя.

В базовом классе этот метод задает переменную-член CBasePin::m_mt и возвращает S_OK. Производный класс может переопределить этот метод, если ему требуется уведомление при установке типа носителя.

Требования

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

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

Класс CBasePin

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