Adjusts the settings of a recording input source.
BOOL BASS_RecordSetInput( int input, DWORD flags, float volume );
|input||The input to adjust the settings of... 0 = first, -1 = master.|
|flags||The new setting... a combination of these flags.|
|volume||The volume level... 0 (silent) to 1 (max), less than 0 = leave current.|
Return valueIf successful, TRUE is returned, else FALSE is returned. Use BASS_ErrorGetCode to get the error code.
|BASS_ERROR_INIT||BASS_RecordInit has not been successfully called.|
|BASS_ERROR_ILLPARAM||input or volume is invalid.|
|BASS_ERROR_NOTAVAIL||The input does not have the necessary controls to apply the flags and/or volume. If attempting to set both at the same time, try separating them to determine which is unavailable.|
|BASS_ERROR_UNKNOWN||Some other mystery problem!|
RemarksThe actual volume level may not be exactly the same as requested, due to underlying precision differences. BASS_RecordGetInput can be used to confirm what the volume is.
The volume curve used by this function is always linear; the BASS_CONFIG_CURVE_VOL config option setting has no effect on this.
Changes made by this function are system-wide, ie. other software using the device will be affected by it.
Platform-specificOn OSX, there is no master input (-1), and only the currently enabled input may have its volume set (if it has a volume control).
ExampleEnable the first input, and set its volume level to 50%.
BASS_RecordSetInput(0, BASS_INPUT_ON, 0.5);