BASS_SamplePlay

Plays a sample, using the sample's default attributes.

HCHANNEL WINAPI BASS_SamplePlay( HSAMPLE handle );

Parameters

handle Handle of the sample to play.

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_NO3D The sample has 3D functionality... BASS_SamplePlay3D 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_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!

Remarks
Use BASS_SampleGetInfo and BASS_SampleSetInfo to set a sample's default attributes.

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_NO3D	The sample has 3D functionality... BASS_SamplePlay3D 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_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!