mmSeekToTime

Sets all tracks in a multimedia file to a specific time during a play operation.

Prototype

DWORD mmSetSeekTime ( MMFile *pMMFile, unsigned int seekTime)

Argument	Description
pMMFile	A pointer to the object that controls the multimedia file.
seekTime	A specific track time within a file relative to the beginning of the file, specified in milliseconds.

Return values

Return value	Description
SUCCESS
MMERR_NO_SYNC_TABLE	File does not have a sync table.
MMERR_INVALID_FILE	pMMFile is NULL.
MMERR_INVALID_TIME	The seekTime is invalid. This error is returned if either of the following is true: seekTime is greater than the last sync point time. seekTime is less than the first sync point time.

Details

Use mmSeekToTime to seek to a specified time relative to the start of a file. The track pointer for all tracks is repositioned to the specified time. mmSeekToTime can be called only during a play operation. A seek operation can be performed when using partial buffer mode (not single buffer mode).

When the application calls mmSeekToTime on a time that does not match a sync point, the track pointer is repositioned to the next seek point’s time.

Example

DWORD ret;
ret = mmSeekToTime(&mmFile, seekTime);
If( ret != SUCCESS )
{
printf ("\nERROR in mmSeekToTime (%d)\n", ret);
return -1;
}