Метод IMFSeekInfo::GetNearestKeyFrames (mfidl.h)

  • Статья

Для конкретной позиции поиска получает два ближайших ключевых кадра.

Синтаксис

HRESULT GetNearestKeyFrames(
  [in]  const GUID        *pguidTimeFormat,
  [in]  const PROPVARIANT *pvarStartPosition,
  [out] PROPVARIANT       *pvarPreviousKeyFrame,
  [out] PROPVARIANT       *pvarNextKeyFrame
);

Параметры

[in] pguidTimeFormat

Указатель на GUID, указывающий формат времени. Формат времени определяет единицы для других параметров этого метода. Если значение равно GUID_NULL, то формат времени будет равен 100 наносекундным единицам. Некоторые источники мультимедиа могут поддерживать идентификаторы GUID дополнительного формата времени.

[in] pvarStartPosition

Позиция поиска. Единицы измерения для этого параметра задаются с помощью pguidTimeFormat.

[out] pvarPreviousKeyFrame

Получает позицию ближайшего ключевого кадра, который появляется раньше pvarStartPosition. Единицы измерения для этого параметра задаются с помощью pguidTimeFormat.

[out] pvarNextKeyFrame

Получает позицию ближайшего ключевого кадра, который появляется позже pvarStartPosition. Единицы измерения для этого параметра задаются с помощью pguidTimeFormat.

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

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Метод выполнен успешно.
MF_E_UNSUPPORTED_TIME_FORMAT
 Формат времени, указанный в pguidTimeFormat , не поддерживается.

Комментарии

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

Требования

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

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

IMFSeekInfo