CPullPin::Seek

  • Article
 
Microsoft DirectShow 9.0

CPullPin::Seek

The Seek method sets the start and stop positions of the stream.

Syntax

  HRESULT Seek(
    REFERENCE_TIME tStart,
    REFERENCE_TIME tStop
);

Parameters

tStart

Specifies the start position, in bytes multiplied by 10,000,000.

tStop

Specifies the stop position, in bytes multiplied by 10,000,000.

Return Values

Returns S_OK if the method succeeds, or an error code otherwise.

Remarks

If the worker thread is running, the method pauses the thread, flushes the filter graph, and resumes the thread. The thread begins pulling data from the new start position. Otherwise, the new position values become effective whenever the thread is started.

Positions are relative to the start of the original source. Multiply the desired byte offsets by the constant UNITS, which is defined in the base class library as 10,000,000.

When the pin first connects, the stop and start positions default to the beginning and end of the stream.

Requirements

**  Header:** Include Pullpin.h and Streams.h.

**  Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

See Also