Интерфейс IMFVideoProcessor (evr9.h)

  • Статья

Управляет обработкой видео в расширенном отрисовщике видео (EVR). Операции, управляемые с помощью этого интерфейса, включают настройку цвета (ProcAmp), фильтры шума и фильтры сведений.

Микшер EVR реализует этот интерфейс. Чтобы получить указатель на интерфейс, вызовите IMFGetService::GetService. Идентификатор службы — GUID MR_VIDEO_MIXER_SERVICE. Вызовите GetService для любого из следующих объектов:

  • Сеанс мультимедиа (если топология содержит экземпляр EVR).
  • Приемник носителя EVR.
  • Фильтр DirectShow EVR.
  • Миксер EVR.
Если вы реализуете пользовательский микшер для EVR, при необходимости микшер может предоставить этот интерфейс как услугу.

Наследование

Интерфейс IMFVideoProcessor наследуется от интерфейса IUnknown . IMFVideoProcessor также имеет следующие типы членов:

Методы

Интерфейс IMFVideoProcessor имеет следующие методы.

 
IMFVideoProcessor::GetAvailableVideoProcessorModes

Извлекает режимы видеопроцессоров, поддерживаемые видеодрайвером.
IMFVideoProcessor::GetBackgroundColor

Извлекает цвет фона для прямоугольника композиции. Цвет фона используется для почтового ящика видео.
IMFVideoProcessor::GetFilteringRange

Извлекает диапазон значений для указанного параметра фильтра изображений.
IMFVideoProcessor::GetFilteringValue

Извлекает текущий параметр для фильтра изображений.
IMFVideoProcessor::GetProcAmpRange

Извлекает диапазон значений для параметра настройки цвета (ProcAmp).
IMFVideoProcessor::GetProcAmpValues

Извлекает текущие параметры для одного или нескольких параметров настройки цвета (ProcAmp).
IMFVideoProcessor::GetVideoProcessorCaps

Извлекает возможности режима видеопроцессоров.
IMFVideoProcessor::GetVideoProcessorMode

Извлекает предпочтительный режим видеопроцессоров приложения. Чтобы задать предпочтительный режим, вызовите IMFVideoProcessor::SetVideoProcessorMode.
IMFVideoProcessor::SetBackgroundColor

Задает цвет фона для прямоугольника композиции. Цвет фона используется для почтового ящика видео.
IMFVideoProcessor::SetFilteringValue

Задает параметр для фильтра изображений.
IMFVideoProcessor::SetProcAmpValues

Задает один или несколько параметров настройки цвета (ProcAmp).
IMFVideoProcessor::SetVideoProcessorMode

Задает предпочтительный режим видеопроцессоров. EVR попытается использовать этот режим при запуске воспроизведения.

Комментарии

Этот интерфейс предоставляет доступ к функциональным возможностям, реализованным графическим драйвером. Драйвер предоставляет один или несколько режимов видеопроцессора, которые идентифицируются по GUID. Каждый режим имеет собственный набор возможностей. Список доступных режимов может изменяться в зависимости от типа мультимедиа видео.

Чтобы использовать этот интерфейс, выполните следующие действия.

  1. Инициализируйте типы мультимедиа во входных потоках EVR. (Если вы используете сеанс мультимедиа, это происходит после разрешения топологии. Дождитесь, пока сеанс мультимедиа отправит событие MESessionTopologyStatus со значением состояния MF_TOPOSTATUS_READY.)
  2. Вызовите IMFVideoProcessor::GetAvailableVideoProcessorModes , чтобы получить список доступных режимов видеопроцессора.
  3. Вызовите IMFVideoProcessor::GetVideoProcessorCaps , чтобы найти возможности каждого режима видеопроцессора.
  4. Вызовите IMFVideoProcessor::SetVideoProcessorMode , чтобы выбрать режим. Если пропустить этот шаг, EVR автоматически выбирает режим видеопроцессоров при запуске потоковой передачи. В этом случае дождитесь начала воспроизведения, прежде чем перейти к шагу 5.
  5. Вызовите imfVideoProcessor::GetProcAmpRange и IMFVideoProcessor::GetFilteringRange , чтобы найти диапазон значений для различных параметров ProcAmp и фильтра изображений.
  6. Вызовите IMFVideoProcessor::SetProcAmpValues и IMFVideoProcessor::SetFilteringValue , чтобы изменить параметры procAmp и фильтра изображений.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header evr9.h

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

Расширенный отрисовщик видео

Интерфейсы Media Foundation