Retrieves the level (peak amplitude) of a sample, stream, MOD music or recording channel.
Namespace: Un4seen.Bass
Assembly: Bass.Net (in Bass.Net.dll) Version: 2.4.17.5
Syntax
[DllImportAttribute("bass", EntryPoint = "BASS_ChannelGetLevelEx")] public static bool BASS_ChannelGetLevel( int handle, float[] levels, float length, BASSLevel flags )
Parameters
- handle
- Type: SystemInt32
The channel handle... a HCHANNEL, HMUSIC, HSTREAM, or HRECORD. - levels
- Type: SystemSingle
The array in which the levels are to be returned. - length
- Type: SystemSingle
How much data (in seconds) to look at to get the level. - flags
- Type: Un4seen.BassBASSLevel
What levels to retrieve. One of the following (see BASSLevel):BASS_LEVEL_ALL Retrieves a separate level for each channel. BASS_LEVEL_MONO Retrieve a single mono level. 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 Flag: Get the RMS level. Otherwise the peak level. BASS_LEVEL_VOLPAN Apply the current BASS_ATTRIB_VOL and BASS_ATTRIB_PAN values to the level reading. BASS_LEVEL_NOREMOVE Do not remove the inspected data from a (recording) channel's buffer. This is automatic if the recording channel is using a RECORDPROC callback function. This flag is ignored on other channel types.
Return Value
Type: BooleanOn success is returned - else , use BASS_ErrorGetCode to get the error code.
If successful, the requested levels are returned in the levels array.
Remarks
ERROR CODE | Description |
---|---|
BASS_ERROR_HANDLE | handle is not a valid channel. |
BASS_ERROR_NOPLAY | The channel is not playing. |
BASS_ERROR_ENDED | The decoding channel has reached the end. |
BASS_ERROR_BUFLOST | Should not happen... check that a valid window handle was used with BASS_Init(Int32, Int32, BASSInit, IntPtr, IntPtr). |
See Also