BASS_ChannelSetDevice
Changes the device that a stream, MOD music or sample is using.
BOOL BASS_ChannelSetDevice(
DWORD handle,
DWORD device
);
Parameters
| handle | The channel or sample handle... a HMUSIC, HSTREAM or HSAMPLE. |
| device | The device to use... 0 = no sound, 1 = first real output device. |
Return value
If successful, TRUE is returned, else FALSE is returned and the channel remains on its current device. Use BASS_ErrorGetCode to get the error code.Error codes
| 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. |
| 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! |
Remarks
All of the channel's current settings are carried over to the new device, but if the channel is using the "with FX flag" DX8 effect implementation, the internal state (eg. buffers) of the DX8 effects will be reset. When using the "without FX flag" DX8 effect implementation, the state of the DX8 effects is preserved.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.