BASS_SamplePlayEx

Plays a sample from an offset, overriding the sample's default attributes with those specified.

HCHANNEL WINAPI BASS_SamplePlayEx( HSAMPLE handle, DWORD start, int freq, int volume, int pan, BOOL loop );

Parameters

handle Handle of the sample to play.

start Playback start position in samples (not bytes).

freq The sample rate... 100 (min) - 100000 (max), -1 = use sample's default.

volume The volume... 0 (silent) - 100 (max), -1 = use sample's default.

pan The panning position... -100 (left) - 100 (right), -101 = use sample's default.

loop TRUE = Loop the sample... -1 = use sample's default.

Return value
If successful, the handle of the channel used to play the sample is returned, else NULL is returned. Use BASS_ErrorGetCode to get the error code.

Error codes

BASS_ERROR_START The digital output has not been started. Use BASS_Start to do so.

BASS_ERROR_HANDLE handle is not a valid sample handle.

BASS_ERROR_FREQ freq is out of range... DirectSound only allows sample rates between 100 and 100000.

BASS_ERROR_NO3D The sample has 3D functionality... BASS_SamplePlay3DEx should be used to play it.

BASS_ERROR_NOCHAN The sample has no free channel on which to be played... the maximum number of simultaneous playbacks has been reached, and no BASS_SAMPLE_OVER flag was specfied for the sample.

BASS_ERROR_POSITION The start position is beyond the end of the sample.

BASS_ERROR_NOHW No hardware voices are available... this only occurs if the sample was loaded or created with the BASS_SAMPLE_VAM flag, and BASS_VAM_HARDWARE is set in the sample's VAM mode, and there are no hardware voices available to play it.
BASS_ERROR_BUFLOST Should not happen, but... PLEASE REPORT IT IF YOU DO GET THIS ERROR!

handle	Handle of the sample to play.
start	Playback start position in samples (not bytes).
freq	The sample rate... 100 (min) - 100000 (max), -1 = use sample's default.
volume	The volume... 0 (silent) - 100 (max), -1 = use sample's default.
pan	The panning position... -100 (left) - 100 (right), -101 = use sample's default.
loop	TRUE = Loop the sample... -1 = use sample's default.

BASS_ERROR_START	The digital output has not been started. Use BASS_Start to do so.
BASS_ERROR_HANDLE	handle is not a valid sample handle.
BASS_ERROR_FREQ	freq is out of range... DirectSound only allows sample rates between 100 and 100000.
BASS_ERROR_NO3D	The sample has 3D functionality... BASS_SamplePlay3DEx should be used to play it.
BASS_ERROR_NOCHAN	The sample has no free channel on which to be played... the maximum number of simultaneous playbacks has been reached, and no BASS_SAMPLE_OVER flag was specfied for the sample.
BASS_ERROR_POSITION	The start position is beyond the end of the sample.
BASS_ERROR_NOHW	No hardware voices are available... this only occurs if the sample was loaded or created with the BASS_SAMPLE_VAM flag, and BASS_VAM_HARDWARE is set in the sample's VAM mode, and there are no hardware voices available to play it.
BASS_ERROR_BUFLOST	Should not happen, but... PLEASE REPORT IT IF YOU DO GET THIS ERROR!