IAMTimecodeGenerator interface (strmif.h)
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.
Inheritance
The IAMTimecodeGenerator interface inherits from the IUnknown interface. IAMTimecodeGenerator also has these types of members:
Methods
The IAMTimecodeGenerator interface has these methods.
| IAMTimecodeGenerator::get_VITCLine The get_VITCLine method retrieves which line(s) the vertical interval timecode information has been inserted into. |
| IAMTimecodeGenerator::GetTCGMode The GetTCGMode method retrieves the SMPTE timecode generator properties. |
| IAMTimecodeGenerator::GetTimecode The GetTimecode method retrieves the most recent timecode and/or userbit value available in the stream. |
| IAMTimecodeGenerator::put_VITCLine The put_VITCLine method specifies which line to insert the vertical interval timecode information into. |
| IAMTimecodeGenerator::SetTCGMode The SetTCGMode method sets the SMPTE timecode generator properties. |
| IAMTimecodeGenerator::SetTimecode The SetTimecode method sets the timecode, userbit value, or both. |
Requirements
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |