Share via


Controls.currentPositionTimecode

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The currentPositionTimecode property specifies or retrieves the current position in the current media item using a time code format. This property currently supports SMPTE time code.

player.controls.currentPositionTimecode
      

Possible Values

This property is a read/write String.

Remarks

SMPTE time code provides a standard way of identifying an individual video frame, which is useful for synchronizing playback. If a digital media file supports SMPTE time code, Windows Media Player can retrieve the current time code position information or seek to a video frame identified by a particular time code String.

SMPTE time code identifies a particular frame by the number of hours, minutes, seconds, and frames that separate it from a particular reference frame the frame designated as time zero. Usually the time zero frame is the start of the file and a particular SMPTE time code value represents the elapsed time since the start of the file.

The time code String is in the format [range]hh:mm:ss.ff where [range] represents the range, hh represents hours, mm represents minutes, ss represents seconds, and ff represents frames. When specifying a value using currentPositionTimecode, you must include all eight digits using zeros as placeholders.

The [range] specifier corresponds to the wRange member of the Windows Media Format WMT_TIMECODE_EXTENSION_DATA structure. For more information about time code ranges, see the Windows Media Format SDK.

Specifying and retrieving currentPositionTimecode is only supported for files that contain SMPTE time code information.

Examples

The following code example specifies currentPositionTimecode as 1 hour, zero minutes, 30 seconds, and 5 frames. The Player object was created with ID = "Player".

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

Requirements

Requirement Value
Version
Windows Media Player 9 Series or later.
DLL
Wmp.dll

See also

Controls Object