IAMTimecodeReader::SetTCRMode method (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 SetTCRMode method sets the timecode reader properties.

This method is not implemented.

Syntax

HRESULT SetTCRMode(
  [in] long Param,
  [in] long Value
);

Parameters

[in] Param

Property you want to set (use ED_TCR_SOURCE or ED_TCR_NOTIFY_ENABLE).

[in] Value

Value of the specified property; If Param returns ED_TCR_NOTIFY_ENABLE, then this value will return OATRUE or OAFALSE. If Param returns ED_TCR_SOURCE, then this value must be one of the following.

Value Description
ED_TCR_CT Control Track.
ED_TCR_LTC Linear Timecode.
ED_TCR_VITC Vertical Interval Timecode.
ED_TCR_LAST_VALUE Return last read value.

Return value

Returns E_NOTIMPL.

Remarks

Linear timecode is recorded on an analog audio track as an NRZ bi-phase mark-encoded signal. Each timecode frame is one video frame time in duration.

Vertical timecode is usually stored in two lines of a video signal's vertical interval, somewhere between 10 and 20.

Control track is a once-per-frame signal recorded on a special track on a tape. The head and drive servo mechanisms use it to keep everything locked. It is also used to drive the counter on machines without timecode capability, and can optionally be used on machines equipped with a timecode reader.

Note that ED_TCR_LAST_VALUE is used when implementing timecode notification because the application does not want to initiate another timecode request to the external device. This method is not recommended for frame-accurate applications because of multithreading issues.

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)
Library Strmiids.lib

See also

Error and Success Codes

IAMTimecodeReader Interface

IAMTimecodeReader::GetTCRMode