IAMTimecodeGenerator interface (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
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
| Requirement | Value |
|---|---|
| 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) |