[API function]
Sets the FMOD internal mixing buffer size.
It is configurable because low buffersizes use less memory, but are more instable.
More importantly, increasing buffer size will increase sound output stability, but
on the other hand increases latency, and to some extent, CPU usage.
* FMOD chooses the most optimal size by default for best stability, depending on the
output type - and if the drivers are emulated or not (NT).
It is not recommended changing this value unless you really need to. You may get worse
performance than the default settings chosen by FMOD.
signed char F_API FSOUND_SetBufferSize(
int len_ms
);
Parameters
len_ms |
The buffer size in milliseconds.
|
Return Value
On success, TRUE is returned.
On failure, (ie if FMOD is already active) FALSE is returned.
Remarks
This function cannot be called after FMOD is already activated with FSOUND_Init.
It must be called before FSOUND_Init, or after FSOUND_Close.
---------
The buffersize seting defaults to 50ms if it is not called for DSOUND and A3D. It defaults to
200ms for Windows Multimedia wave-out or for emulated DirectSound drivers (such as NT drivers).
---------
Buffer sizes lower than 25 are clamped at 25.
Buffer sizes are also rounded DOWN to the nearest multiple of 25. This is because FMOD mixes in blocks of 25ms.
See Also
FSOUND_Close
,
FSOUND_DSP_GetBufferLengthTotal
,
FSOUND_Init
This document copyright ©Firelight Multimedia, 1999-2001. All rights reserved.
Generated Thu Sep 13 00:18:09 2001
by SourceDoc v0.10, the automated source code documenter.