Share via

IAMTimecodeGenerator Interface

  • Article
 
Microsoft DirectShow 9.0

IAMTimecodeGenerator Interface

The IAMTimecodeGenerator interface controls how an external SMPTE/MIDI timecode generator supplies data to the filter graph.

DirectShow currently does not provide any filters that implement this interface. Third parties should implement this interface on any filter that controls an external timecode generator. Timecode generators can be built into a VCR or can be separate external devices. The device must be able to read timecode and send it to the computer over its control interface. If not, the user must have a timecode reader card in the computer, or you can write a software decoder that converts VITC embedded in captured video frames or LTC captured as an audio signal into DirectShow timecode samples.

SMPTE timecode is a frame addressing system that identifies video and audio sources, makes automatic track synchronization possible, and provides a container for additional data related to the production. SMPTE timecode's main purpose is to provide a machine-readable address for video and audio. It is displayed in hh:mm:ss:ff format and is thoroughly defined in ANSI/SMPTE 12-1986.

Optionally, you can enable applications to convert timecode to  reference time by supporting the IMediaSeeking::ConvertTimeFormat method on the filter.

Hardware Requirements

For hardware requirements, see the IAMExtTransport interface.

In addition to the methods inherited from IUnknown, the IAMTimecodeGenerator interface exposes the following methods.

Method Description
GetTCGMode Retrieves the SMPTE timecode generator properties.
SetTCGMode Sets the SMPTE timecode generator properties.
put_VITCLine Specifies which line(s) to insert the vertical interval timecode information into.
get_VITCLine Retrieves which line(s) the vertical interval timecode information has been inserted into.
SetTimecode Sets the timecode, userbit value, or both.
GetTimecode Retrieves the most recent timecode and/or userbit value available in the stream.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also