IAMExtTransport::SetChase

  • Article
 
Microsoft DirectShow 9.0

IAMExtTransport::SetChase

The SetChase method enables or disables chase mode.

This method is not implemented.

Syntax

  HRESULT SetChase(
  long Enable,
  long Offset,
  HEVENT hEvent
);

Parameters

Enable

[in]  Specifies whether chase is enabled as a long integer.

Value Description
OATRUE Enable chase.
OAFALSE Disable chase.

Offset

[in]  Specifies the offset that the transport will maintain from a reference time. The offset is given in the current time format; see IAMExtTransport::SetTransportBasicParameters for more information.

hEvent

[in]  Specifies a handle to an event. The device signals the event after it has established the signal offset.

Return Values

When this method succeeds, it returns S_OK. Otherwise it returns an HRESULT error code.

Remarks

Use this method when you want an external transport to follow a timecode signal by a fixed offset. For example, if a VCR supports chasing, it can switch to play mode and keep the tape at a fixed offset from a reference timecode.

Chase mode remains in effect until it completes or is canceled. The filter must verify that the transport is maintaining the fixed offset, by periodically reading the transport's timecode.

DV Implementation

MSDV does not support this method. It returns E_NOTIMPL.

Requirements

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

Library: Use Strmiids.lib.

See Also