Changes the device that a stream, MOD music or sample is using.
BOOL BASS_ChannelSetDevice( DWORD handle, DWORD device );
|handle||The channel or sample handle... a HMUSIC, HSTREAM or HSAMPLE.|
|device||The device to use... 0 = no sound, 1 = first real output device, BASS_NODEVICE = no device.|
|BASS_ERROR_HANDLE||handle is not a valid channel.|
|BASS_ERROR_DEVICE||device is invalid.|
|BASS_ERROR_INIT||The requested device has not been initialized.|
|BASS_ERROR_ALREADY||The channel is already using the requested device.|
|BASS_ERROR_NOTAVAIL||Only decoding channels are allowed to use the "no sound" device or the BASS_NODEVICE option. Final output mix streams (using STREAMPROC_DEVICE) cannot be moved to another device.|
|BASS_ERROR_FORMAT||The sample format is not supported by the device/drivers. If the channel is more than stereo or the BASS_SAMPLE_FLOAT flag is used, it could be that they are not supported.|
|BASS_ERROR_MEM||There is insufficient memory.|
|BASS_ERROR_UNKNOWN||Some other mystery problem!|
When changing a sample's device, all the sample's existing channels (HCHANNELs) are freed. It is not possible to change the device of an individual sample channel.
The BASS_NODEVICE option can be used to disassociate a decoding channel from a device, so that it does not get freed when BASS_Free is called.