BASS_CONFIG_DEV_DEFAULT config option


Include a "Default" entry in the output device list?

BASS_SetConfig(
    BASS_CONFIG_DEV_DEFAULT,
    BOOL default
);

Parameters

defaultIf TRUE, a "Default" device will be included in the device list.

Remarks

This option adds a "Default" entry to the output device list, which maps to the device that is currently the system's default. Its output will automatically switch over when the system's default device setting changes.

When enabled, the "Default" device will also become the default device to BASS_Init (with device = -1). Both it and the device that it currently maps to will have the BASS_DEVICE_DEFAULT flag set by BASS_GetDeviceInfo.

This option can only be set before BASS_GetDeviceInfo or BASS_Init has been called.

Platform-specific

This config option is only available on Windows and OSX. On Windows, the automatic device switching feature requires Windows Vista or above (Windows 7 when DirectSound is used).

When the "Default" device is used with DirectSound, the BASS_SetVolume and BASS_GetVolume functions work a bit differently to usual; they deal with the "session" volume, which only affects the current process's output on the device, rather than the device's volume.

See also

BASS_GetConfig, BASS_SetConfig, BASS_Init