This method sets the seek location of all contained media streams to the specified time.
HRESULT Seek( STREAM_TIME SeekTime );
[in] STREAM_TIME value that specifies the seek time.
Returns one of the following values.
|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.|
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.
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.
Last updated on Wednesday, April 13, 2005
© 2005 Microsoft Corporation. All rights reserved.