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

Ищет новую позицию в источнике мультимедиа.

Синтаксис

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

Параметры

[in] guidTimeFormat

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

Ценность	Meaning
GUID_NULL	100-наносекунд единиц.

 

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

[in] varPosition

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

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

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

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

Замечания

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

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

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

Требования

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

См. также

МВФSourceReader

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