IMultiMediaStream::Seek

Windows CE .NET

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

HRESULT Seek(
  STREAM_TIME SeekTime
);

Parameters

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

Return Values

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

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.

See Also

IMultiMediaStream Interface


Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.

Show: