ImageGear for C and C++ on Linux v18.8 - Updated
IG_mult_audio_seek_time
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Multimedia Functions > IG_mult_audio_seek_time

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);

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.