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.