SpiSeekStream - Parameters

hstream (HSTREAM) - input

The stream that is to perform the specified action.

ulFlags (ULONG) - input

Contains none or some of the following flags:

SPI_SEEK_ABSOLUTE

Seek from beginning of stream. This is the default setting.
SPI_SEEK_RELATIVE
Seek from current location.
SPI_SEEK_FROMEND
Seek from end of data object.
SPI_SEEK_SLAVES
Seek master as well as all slaves in the sync group. This flag can be used with any of the other flags.
SPI_SEEK_MMTIME
lSeekPoint is expressed in terms of MMTIME units (1/3000th of a second). This is the default setting.
SPI_SEEK_BYTES
lSeekPoint is expressed in bytes.
SPI_SEEK_IFRAME
Seek to nearest I-frame preceding the seek point.

lSeekPoint (LONG) - input

The point to which the stream attempts to seek.

rc (ULONG) - returns

Return codes indicating success or the type of failure:

NO_ERROR

Success.
ERROR_INVALID_FUNCTION
Invalid function requested.
ERROR_INVALID_STREAM
Invalid stream handle.
ERROR_INVALID_FLAG
The flag passed is invalid.
ERROR_INVALID_MMTIME
The specified MMTIME format is not understood by this stream.
ERROR_STREAM_NOT_STOP
The stream cannot perform the requested function unless the stream is stopped.
ERROR_DATA_ITEM_NOT_SPECIFIED
The data object is not specified.
ERROR_STREAM_NOT_SEEKABLE
Seek is an invalid request for this stream. (For example, seeking on a record does not make sense).
ERROR_STREAM_NOTMASTER
Seek stream with SPI_START_SLAVES flag was specified, but the stream handle passed was not a synchronization master stream.
ERROR_DATA_ITEM_NOT_SEEKABLE
Seek is an invalid request for the data object.
ERROR_NOT_SEEKABLE_BY_TIME
Cannot seek the data object using an MMTIME value.
ERROR_NOT_SEEKABLE_BY_BYTES
Cannot seek the data object using a byte value.
FAILURE
Stream handler-specific error return code.

---

[Back: SpiSeekStream Return Value - rc]
[Next: SpiSeekStream - Remarks]