Initializes a recording device.
BOOL BASS_RecordInit( int device );
|device||The device to use... -1 = default device, 0 = first. BASS_RecordGetDeviceInfo can be used to enumerate the available devices.|
Return valueIf successful, TRUE is returned, else FALSE is returned. Use BASS_ErrorGetCode to get the error code.
|BASS_ERROR_DX||A sufficient version of DirectX (or ALSA) is not installed.|
|BASS_ERROR_DEVICE||device is invalid.|
|BASS_ERROR_ALREADY||The device has already been initialized. BASS_RecordFree must be called before it can be initialized again.|
|BASS_ERROR_DRIVER||There is no available device driver.|
RemarksThis function must be successfully called before using the recording features.
Simultaneously using multiple devices is supported in the BASS API via a context switching system; instead of there being an extra "device" parameter in the function calls, the device to be used is set prior to calling the functions. BASS_RecordSetDevice is used to switch the current recording device. When successful, BASS_RecordInit automatically sets the current thread's device to the one that was just initialized.
When using the default device (device = -1), BASS_RecordGetDevice can be used to find out which device it was mapped to.
Platform-specificRecording support requires DirectX 5 (or above) on Windows.
On Linux, a "Default" device is hardcoded to device number 0, which uses the default input set in the ALSA config; that could map directly to one of the other devices or it could use ALSA plugins.