BASS_SamplePlay3D

Plays a sample with 3D functionality, using the sample's default attributes.

HCHANNEL WINAPI BASS_SamplePlay3D( HSAMPLE handle BASS_3DVECTOR *pos, BASS_3DVECTOR *orient, BASS_3DVECTOR *vel );

Parameters

handle Handle of the sample to play.

pos Position of the sound... NULL = x / y / z = 0.

orient Orientation of the sound... NULL = x / y / z = 0.

vel Velocity of the sound... NULL = x / y / z = 0. This is only used to calculate the doppler effect, and has no effect on the sound's position.

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 does not have 3D functionality... BASS_SamplePlay 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.

handle	Handle of the sample to play.
pos	Position of the sound... NULL = x / y / z = 0.
orient	Orientation of the sound... NULL = x / y / z = 0.
vel	Velocity of the sound... NULL = x / y / z = 0. This is only used to calculate the doppler effect, and has no effect on the sound's position.

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 does not have 3D functionality... BASS_SamplePlay 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!