IXStudioFileIterator::Seek Method

Important The XStudio native C nano-COM APIs have been deprecated in favor of the KStudio native C nano-COM APIs.
Seeks to a new position in the file.

Syntax

public:
HRESULT Seek(
         UINT64 tick
)  

Parameters

tick
Type: UINT64 

[in] Tick count of the position to seek to. To clear the seek position, use XSTUDIO_TICK_INVALID.

Return value

Type: HRESULT 

S_OK if successful; an error code otherwise.

Remarks

Call GetTickRange to determine the tick count range of the file.

After seeking to a new position, call GetNextEvent to get the next event at that position.

Note that seeking to a tick value of zero resets the iterator and allows your code to make changes to loop counts and in and out points on the iterator. Trying to change those values without resetting the tick value to zero will result in an E_XSTUDIO_INVALID_OPERATION error.

Requirements

Header: Declared in xstudio.h.

Library: Use xstudioclient.lib (console) or xstudioservice.lib (desktop).