Compartir a través de


IMultiMediaStream::Seek (Compact 2013)

3/26/2014

This method sets the seek location of all contained media streams to the specified time.

Syntax

HRESULT Seek(
  STREAM_TIME SeekTime
);

Parameters

  • SeekTime
    [in] STREAM_TIME value that specifies the seek time.

Return Value

Returns one of the following values.

Value

Description

E_POINTER

One of the pointers is invalid.

MS_E_NOSEEKING

One or more media streams do not support seeking.

MS_E_WRITESTREAM

The streams are writable and therefore do not support seeking.

S_OK

Success.

Remarks

This method will not work on streams that do not support seeking.

Before calling this method, retrieve the stream's capabilities by calling IMultiMediaStream::GetInformation.

If the retrieved value includes the MMSSF_SUPPORTSEEK flag, you can call this method.

When seeking a stream that has a clock, the current time can change to an unpredictable value, including a time before the desired seek time. This causes the method to fail.

This method seeks to the specified time in all the media streams derived from the multimedia stream object.

Requirements

Header

dshow.h

Library

Strmiids.lib

See Also

Reference

IMultiMediaStream Interface