IMultiMediaStream::Seek (Windows Embedded CE 6.0)
1/6/2010
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
| Windows Embedded CE | Windows CE 2.12 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later |