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_current_frame_seek
In This Topic
    IG_mult_current_frame_seek
    In This Topic

    This function seeks to the given frame number in a multimedia instance.

    Declaration:

     
    Copy Code
    AT_ERRCOUNT ACCUAPI IG_mult_current_frame_seek(
            HIGMULT hMult, 
            AT_UINT frameNum
    );
    

    Arguments:

    Name Type Description
    hMult HIGMULT Multimedia instance handle.
    frameNum AT_UINT Frame number to seek to (0 = first frame).

    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
    /* Seek to last frame */
    AT_ERRCOUNT nErrcount;  /* Number of errors on stack */
    AT_UINT numFrames;      /* Total number of frames */
    nErrcount = IG_mult_duration_get(hMult, &numFrames, NULL);
    nErrcount = IG_mult_current_frame_seek(hMult, numFrames - 1);