Previous Topic Index Next Topic
[API function]

FSOUND_SetMinHardwareChannels

This sets the minimum allowable hardware channels before FMOD drops back to 100 percent software.
This is helpful for minimum spec cards, and not having to guess how many hardware channels
they might have. This way you can guarantee and assume a certain number of channels for
your application and place them all in FSOUND_HW3D without fear of the playsound failing
because it runs out of channels on a low spec card.

DLL_API signed char F_API FSOUND_SetMinHardwareChannels(
int min
);

Parameters

min The minimum number of hardware channels allowable on a card before it uses the software engine 1004562604f the time.

Return Value

On success, TRUE is returned.
On failure, 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.
---------
As an example, if you set your minimum to 16, you can now safely guarantee that 16 sounds can be played at once that are created with FSOUND_HW3D.
This way if you do come across a card that only supports 4 channels, it will just drop back to playing ALL sounds in software mode.
It may sound worse, but at least it doesnt fail on the playsound. (which could sound even worse!)
___________________
Supported on the following platforms : Win32, WinCE, Linux, Macintosh, XBox, PlayStation 2, GameCube

See Also

FSOUND_Close , FSOUND_Init , FSOUND_SetMaxHardwareChannels

This document copyright ©Firelight Technologies, Pty, Ltd, 1999-2002. All rights reserved.
Generated Thu Dec 15 17:31:33 2005 by SourceDoc v0.10, the automated source code documenter.