Метод IAMTimecodeReader::GetTimecode (strmif.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Метод GetTimecode извлекает последние значения кода времени, userbit и флага, доступные в потоке.
Синтаксис
HRESULT GetTimecode(
[out] PTIMECODE_SAMPLE pTimecodeSample
);
Параметры
[out] pTimecodeSample
Указатель на структуру TIMECODE_SAMPLE .
Возвращаемое значение
Возвращает значение HRESULT , зависящее от реализации интерфейса.
Комментарии
Используйте этот метод для отслеживания кода времени и анализа дубликатов и разрывов.
Код времени содержит неопределенные биты, называемые userbits. Приложения могут использовать эти биты для хранения сведений о синхронизации или других пользовательских сведений.
Реализация DV и MPEG Camcorder
Драйвер MSDV поддерживает чтение кода времени SMPTE или абсолютных чисел отслеживания (ATN). Драйвер MSTape поддерживает чтение счетчика относительного времени (RTC). Чтобы прочитать сведения о времени на этих устройствах, выполните следующие действия.Задайте для элемента dwFlags структуры TIMECODE_SAMPLE одно из следующих значений.
| Константа | Описание |
|---|---|
| ED_DEVCAP_TIMECODE_READ | Timecode (DV) |
| ED_DEVCAP_ATN_READ | Абсолютный номер дорожки (DV) |
| ED_DEVCAP_RTC_READ | Счетчик относительного времени (лента MPEG) |
Элемент timecode структуры TIMECODE_SAMPLE является структурой TIMECODE . Инициализируйте элемент dwFrames этой структуры равным нулю.
Все остальные элементы структуры игнорируются.
При возврате метода член dwFrames содержит сведения о времени в следующем формате.
| Сведения о времени | Формат |
|---|---|
| Код времени | Часы, минуты, секунды и кадры в виде двоичного закодированного десятичного значения (BCD): 0xhhmmssff. |
| ATN | Номер отслеживания. |
| RTC | Часы, минуты, секунды и кадры в виде значения BCD: 0xhhmmssff. Наиболее значимым битом кадров является бит знака. Если количество кадров недоступно, остальным битам кадра присваивается значение 0x7F. |
Кроме того, член dwUser получает от устройства пустой бит флага , имеющий одно из следующих значений.
| Значение | Описание |
|---|---|
| 0x00 | Не разрыв. |
| 0x01 | Разрыв. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | strmif.h (включая Dshow.h) |
| Библиотека | Strmiids.lib |
См. также раздел
Коды ошибок и успешного выполнения