Unknown

previous page next page

BASS_WASAPI_GetLevelEx

Retrieves the level.

BOOL BASS_WASAPI_GetLevelEx(
    float *levels,
    float length,
    DWORD flags
);

Parameters

levels

An array to receive the levels.

length

The amount of data to inspect to calculate the level, in seconds. The maximum is 1 second. Less data than requested may be used if the full amount is not available, eg. if the device's buffer is shorter.

flags

A combination of these flags.

BASS_LEVEL_MONO	Get a mono level. If neither this or the BASS_LEVEL_STEREO flag is used, then a separate level is retrieved for each channel; the number of channels is available from BASS_WASAPI_GetInfo.
BASS_LEVEL_STEREO	Get a stereo level. The left level will be from the even channels, and the right level will be from the odd channels. If there are an odd number of channels then the left and right levels will both include all channels.
BASS_LEVEL_RMS	Get the RMS level. Otherwise the peak level.

Return value

If successful, TRUE is returned, else FALSE is returned. Use BASS_ErrorGetCode to get the error code.

Error codes

BASS_ERROR_INIT	BASS_WASAPI_Init has not been successfully called.
BASS_ERROR_NOTAVAIL	The BASS_WASAPI_BUFFER flag was not specified in the device's initialization.
BASS_ERROR_ILLPARAM	length is not valid.

Remarks

This function uses BASS_ChannelGetLevelEx internally, so it behaves identically to that.

The BASS_WASAPI_BUFFER flag needs to have been specified in the device's initialization to enable the use of this function.