Метод IMFMediaSession::Start (mfidl.h)

Запускает сеанс мультимедиа.

Синтаксис

HRESULT Start(
  [in] const GUID        *pguidTimeFormat,
  [in] const PROPVARIANT *pvarStartPosition
);

Параметры

[in] pguidTimeFormat

Указатель на GUID, указывающий формат времени для параметра pvarStartPosition . Этот параметр может принимать значение NULL. Значение NULL эквивалентно передаче GUID_NULL.

Определяются идентификаторы GUID следующего формата времени:

Значение Значение
GUID_NULL
Время презентации. Параметр pvarStartPosition должен иметь один из следующих типов PROPVARIANT .
  • VT_I8: параметр pvarStartPosition содержит начальную позицию в единицах 100 наносекунд относительно начала презентации.
  • VT_EMPTY: воспроизведение начинается с текущей позиции.
Все источники мультимедиа поддерживают этот формат времени.
MF_TIME_FORMAT_SEGMENT_OFFSET
Смещение сегмента. Этот формат времени поддерживается источником Sequencer. Начальное время — это смещение в пределах сегмента.

Вызовите функцию MFCreateSequencerSegmentOffset , чтобы создать значение PROPVARIANT для параметра pvarStartPosition .

MF_TIME_FORMAT_ENTRY_RELATIVE
Примечание Требуется Windows 7 или более поздней версии.
 
Перейдите к записи в списке воспроизведения. Параметр pvarStartPosition указывает индекс записи списка воспроизведения относительно текущей записи. Например, значение 2 пропускает две записи. Чтобы пропустить назад, передайте отрицательное значение. Тип PROPVARIANTVT_I4.

Если источник мультимедиа поддерживает этот формат времени, метод IMFMediaSource::GetCharacteristics возвращает один или оба из следующих флагов:

  • MFMEDIASOURCE_CAN_SKIPFORWARD
  • MFMEDIASOURCE_CAN_SKIPBACKWARD

[in] pvarStartPosition

Указатель на PROPVARIANT , указывающий начальную позицию для воспроизведения. Значение и тип данных этого параметра указываются параметром pguidTimeFormat .

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

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

Код возврата Описание
S_OK
Метод выполнен успешно.
MF_E_INVALIDREQUEST
Операция не может быть выполнена в текущем состоянии сеанса мультимедиа.
MF_E_SHUTDOWN
Сеанс мультимедиа завершен.

Комментарии

При вызове этого метода сеанс мультимедиа запускает часы презентации и начинает обрабатывать примеры мультимедиа.

Этот метод является асинхронным. После завершения метода сеанс мультимедиа отправляет событие MESessionStarted .

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header mfidl.h
Библиотека Mfuuid.lib

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

IMFMediaSession