Метод IMFSourceReader::SetCurrentPosition (mfreadwrite.h)

  • Статья

Стремится к новой позиции в источнике средств массовой информации.

Синтаксис

HRESULT SetCurrentPosition(
  [in] REFGUID        guidTimeFormat,
  [in] REFPROPVARIANT varPosition
);

Параметры

[in] guidTimeFormat

Идентификатор GUID, указывающий формат времени. Формат времени определяет единицы для параметра varPosition . Для всех источников мультимедиа определяется следующее значение:

Значение Значение
GUID_NULL
 100-наносекундные единицы.
 

Некоторые источники мультимедиа могут поддерживать дополнительные значения.

[in] varPosition

Позиция, с которой будет запущено воспроизведение. Единицы измерения задаются параметром guidTimeFormat . Если параметр guidTimeFormat имеет значение GUID_NULL, задайте тип варианта VT_I8.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
MF_E_INVALIDREQUEST
 Один или несколько примеров запросов по-прежнему находятся в состоянии ожидания.

Комментарии

Метод SetCurrentPosition не гарантирует точный поиск. Точность поиска зависит от мультимедийного содержимого. Если мультимедийное содержимое содержит видеопоток, метод SetCurrentPosition обычно ищет ближайший ключевой кадр до нужной позиции. Расстояние между ключевыми кадрами зависит от нескольких факторов, включая реализацию кодировщика, видеоконтент и конкретные параметры кодирования, используемые для кодирования содержимого. Расстояние между ключевым кадром может отличаться в пределах одного видеофайла (например, в зависимости от сложности сцены).

После поиска приложение должно вызвать IMFSourceReader::ReadSample и перейти в нужную позицию.

Этот интерфейс доступен в Windows Vista, если установлено дополнение к обновлению платформы для Windows Vista.

Требования

Требование Значение
Минимальная версия клиента Windows 7, Windows Vista и дополнение к обновлению платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header mfreadwrite.h

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

IMFSourceReader

Средство чтения исходного кода