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

Метод IAMVideoCompression::OverrideKeyFrame (strmif.h)

  • Статья

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

Метод OverrideKeyFrame указывает фильтру сжать определенный кадр в качестве ключевого кадра.

Синтаксис

HRESULT OverrideKeyFrame(
  [in] long FrameNumber
);

Параметры

[in] FrameNumber

Указывает номер кадра. Первый кадр, предоставляемый фильтром, пронумерован нулевым.

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

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

Код возврата Описание
S_OK
 Успешно.
E_NOTIMPL
 Не реализован.

Комментарии

Если фильтр поддерживает этот метод, его можно использовать для переопределения нормального распределения по ключевым кадрам для определенного кадра. После того как фильтр создаст ключевой кадр, он может сбросить его число, чтобы определить, когда должен произойти следующий ключевой кадр. Например, если частота ключевых кадров составляет 10, а приложение использует этот метод для принудительного использования кадра 5 в качестве ключевого кадра, фильтр может подождать еще 10 кадров (до кадра 15), прежде чем создать следующий ключевой кадр.

Требования

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

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

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

Интерфейс IAMVideoCompression