ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / Core Component API Reference / Core Component Functions Reference / Multimedia Functions / IG_mult_audio_seek_time
In This Topic
    IG_mult_audio_seek_time
    In This Topic

    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.

    Sample:

    Media Player

    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.