Свойство IWMPControls3::currentPositionTimecode

Статья
06/21/2023

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

Свойство currentPositionTimecode получает или задает текущую позицию в текущем элементе мультимедиа с помощью формата кода времени. Это свойство в настоящее время поддерживает код времени SMPTE.

Синтаксис

public System.String currentPositionTimecode {get; set;}


Public Property currentPositionTimecode As System.String

Значение свойства

Объект System.String, представляющий собой код времени SMPTE.

Код времени SMPTE предоставляет стандартный способ идентификации отдельного видеокадра, который полезен для синхронизации воспроизведения. Если цифровой файл мультимедиа поддерживает код времени SMPTE, Медиаплеер Windows может получать сведения о текущем положении кода времени или искать видеокадр, определенный определенным кодом времени.

Код времени SMPTE определяет конкретный кадр по количеству часов, минут, секунд и кадров, отделяющих его от определенного опорного кадра, обозначенного как нулевое время. Обычно нулевой интервал времени является началом файла, а определенное значение кода времени SMPTE представляет время, прошедшее с момента запуска файла.

Код времени имеет формат [диапазон]чч:мм:сс. ff , где [range] представляет диапазон, hh представляет часы, mm — минуты, ss — секунды, а ff — кадры. При задании значения для currentPositionTimecode необходимо включить все восемь цифр, используя нули в качестве заполнителей.

[range] соответствует члену wRange структуры WMT_TIMECODE_EXTENSION_DATA формата Windows Media. Дополнительные сведения о диапазонах кодов времени см. в разделе Windows Media Format SDK.

Установка и получение currentPositionTimecode поддерживается только для файлов, содержащих сведения о коде времени SMPTE.

Примеры

В следующем примере кода currentPositionTimecode определяется как 1 час, ноль минут, 30 секунд и 5 кадров. Объект AxWMPLib.AxWindowsMediaPlayer представлен переменной с именем player.

// Cast the interface returned by player.Ctlcontrols to an IWMPControls3 interface
// so that you can use the currentPositionTimecode property.
WMPLib.IWMPControls3 controls = (WMPLib.IWMPControls3)player.Ctlcontrols;

// Seek to a frame using SMPTE time code.
controls.currentPositionTimecode = "[00000]01:00:30.05";


' Cast the interface returned by player.Ctlcontrols to an IWMPControls3 interface
&#39; so that you can use the currentPositionTimecode property.
Dim controls As WMPLib.IWMPControls3 = player.Ctlcontrols

&#39; Seek to a frame using SMPTE time code.
Controls.currentPositionTimecode = &quot;[00000]01:00:30.05&quot;

Требования

Требование	Значение
Версия	Медиаплеер Windows серии 9 или более поздней версии
Пространство имен	WMPLib
Сборка	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

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

Интерфейс IWMPControls3 (VB и C#)