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


Метод IMediaSample::GetTime (strmif.h)

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

Метод GetTime извлекает время потока, с которого этот пример должен начинаться и заканчиваться.

Синтаксис

HRESULT GetTime(
  [out] REFERENCE_TIME *pTimeStart,
  [out] REFERENCE_TIME *pTimeEnd
);

Параметры

[out] pTimeStart

Указатель на переменную, которая получает время начала.

[out] pTimeEnd

Указатель на переменную, получающую время остановки. Если в образце нет времени остановки, устанавливается значение времени начала плюс единица.

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

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

Код возврата Описание
S_OK
Успешно. Пример имеет допустимое время начала и остановки.
VFW_S_NO_STOP_TIME
У примера есть допустимое время начала, но нет времени остановки.
VFW_E_SAMPLE_TIME_NOT_SET
Образец не имеет метки времени.

Комментарии

Оба значения времени относятся к времени потока. Дополнительные сведения см. в разделе Время и часы в DirectShow.

Требования

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

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

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

Интерфейс IMediaSample