| Microsoft DirectX 8.1 (C++) |
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.
| Return code | Description |
| E_POINTER | One of the pointers is invalid. |
| MS_E_NOSEEKING | One or more media streams don't support seeking. |
| MS_E_WRITESTREAM | The streams are writable and therefore don't support seeking. |
| S_OK | Success. |
Remarks
This method won't work on streams that don't 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.
See Also