This function sets the format of the audio to be retrieved from a multimedia instance.
Declaration:
Copy Code | |
---|---|
AT_ERRCOUNT ACCUAPI IG_mult_audio_format_set( HIGMULT hMult, LPAT_UINT lpSampleRate, LPAT_UINT lpBitsPerSample, LPAT_UINT lpChannels ); |
Arguments:
hMult | Multimedia instance handle. |
lpSampleRate | Number of samples per second. |
lpBitsPerSample | Number of bits per sample. |
lpChannels | Number of channels (1 = mono, 2 = stereo). |
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 | |
---|---|
/* Ask for 44100Hz 16-bit stereo audio */ AT_ERRCOUNT nErrcount; /* Number of errors on stack */ HIGMULT hMult; /* Multimedia instance handle */ AT_UINT nSampleRate = 44100; /* Sample rate of audio */ AT_UINT nBitsPerSample = 16; /* Bits per sample */ AT_UINT nChannels = 2; /* Number of channels */ nErrcount = IG_mult_audio_format_set(hMult, &nSampleRate, &nBitsPerSample, &nChannels); |
Remarks:
This is not a necessary step under normal circumstances. If possible, the audio will be converted to the format you specify as it is retrieved using IG_mult_audio_get(). If conversion is not possible, an error will occur.