IG_mult_audio_seek

This function sets the starting position within a multimedia instance for the next audio to be retrieved using IG_mult_audio_get().

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_mult_audio_seek_time( HIGMULT hMult, AT_UINT msTime );

Arguments:

Name	Type	Description
hMult	HIGMULT	Multimedia instance handle.
msTime	AT_UINT	Time in milliseconds to which to seek.

Return Value:

Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

	Copy Code
AT_ERRCOUNT nErrcount; /* Number of errors on stack / HIGMULT hMult; / Multimedia instance handle / AT_UINT msDuration; / Duration of file in milliseconds / / Seek to beginning / nErrcount = IG_mult_audio_seek_time(hMult, 0); / Seek to half way */ nErrcount = IG_mult_duration_get(hMult, NULL, &msDuration); nErrcount = IG_mult_audio_seek_time(hMult, msDuration / 2);

Copy Code

AT_ERRCOUNT nErrcount;  /* Number of errors on stack */
HIGMULT hMult;          /* Multimedia instance handle */
AT_UINT msDuration;     /* Duration of file in milliseconds */
/* Seek to beginning */
nErrcount = IG_mult_audio_seek_time(hMult, 0);
/* Seek to half way */
nErrcount = IG_mult_duration_get(hMult, NULL, &msDuration);
nErrcount = IG_mult_audio_seek_time(hMult, msDuration / 2);

Remarks:

If you are streaming audio by calling IG_mult_audio_get() repeatedly, you should not call this function each time you call IG_mult_audio_get(). Excessive seeking could result in discontinuities in the retrieved audio.