WMEncoder.EnableTimecode

  • Article
Windows Media Encoder SDK banner art

The EnableTimecode property specifies and retrieves a Boolean value indicating whether the output will contain a time code.

Syntax

WMEncoder.EnableTimecode = Boolean
Boolean = WMEncoder.EnableTimecode

Parameters

This property takes no parameters.

Property Value

A Boolean that indicates whether a time code is enabled.

If this property fails, it returns an error number.

Return code Number Description
NS_E_INVALIDCALL_WHILE_ENCODER_RUNNING 0xC00D1B66L This property cannot be set while the encoder engine is running.

Remarks

The time code is a way to enable frame-level seeking within video content sourced from digital video files in .avi format, capture devices, and digital devices. A time code generates a larger output file. Typically this feature is used with high-quality content for a download that uses variable bit rate (VBR) mode or is not compressed. You cannot preserve or create a time code when you are applying the inverse telecine filter. You cannot change this property while the encoding process is running.

Note   If you change this property after you have set up a push broadcast, you must regenerate the announcement file.

By default, this property is set to False.

Use the PreserveSourceTimecode property to preserve an existing time code in your source content; otherwise, a new time code is inserted.

Example Code

' Create a WMEncoder object.
  Dim Encoder As WMEncoder
  Set Encoder = New WMEncoder

' Enable the time code and preserve the existing one in the content.
  Encoder.EnableTimecode = True
  Encoder.PreserveSourceTimecode = True

Requirements

Reference: Windows Media Encoder

Library: wmenc.exe

See Also