BASS_RecordGetInput

Retrieves the current settings of a recording input source.

DWORD BASS_RecordGetInput(
    int input,
    float *volume
);

Parameters

input	The input to get the settings of... 0 = first, -1 = master.
volume	Pointer to a variable to receive the volume... NULL = don't retrieve the volume.

Return value

If an error occurs, -1 is returned, use BASS_ErrorGetCode to get the error code. If successful, then the settings are returned. The BASS_INPUT_OFF flag will be set if the input is disabled, otherwise the input is enabled. The type of input is also indicated in the high 8 bits (use BASS_INPUT_TYPE_MASK to test) of the return value, and can be one of the following. If the volume is requested but not available, volume will receive -1.

BASS_INPUT_TYPE_DIGITAL	Digital input source, for example, a DAT or audio CD.
BASS_INPUT_TYPE_LINE	Line-in. On some devices, "Line-in" may be combined with other analog sources into a single BASS_INPUT_TYPE_ANALOG input.
BASS_INPUT_TYPE_MIC	Microphone.
BASS_INPUT_TYPE_SYNTH	Internal MIDI synthesizer.
BASS_INPUT_TYPE_CD	Analog audio CD.
BASS_INPUT_TYPE_PHONE	Telephone.
BASS_INPUT_TYPE_SPEAKER	PC speaker.
BASS_INPUT_TYPE_WAVE	The device's WAVE/PCM output.
BASS_INPUT_TYPE_AUX	Auxiliary. Like "Line-in", "Aux" may be combined with other analog sources into a single BASS_INPUT_TYPE_ANALOG input on some devices.
BASS_INPUT_TYPE_ANALOG	Analog, typically a mix of all analog sources.
BASS_INPUT_TYPE_UNDEF	Anything that is not covered by the other types.

Error codes

BASS_ERROR_INIT	BASS_RecordInit has not been successfully called.
BASS_ERROR_ILLPARAM	input is invalid.
BASS_ERROR_NOTAVAIL	A master input is not available.
BASS_ERROR_UNKNOWN	Some other mystery problem!

Platform-specific

No input control/information is available on the "Default" recording device except on Linux. The master input (-1) is only available on Windows and Linux.

The input type information is only available on Windows. There is no "what you hear" type of input defined; if the device has one, it will typically come under BASS_INPUT_TYPE_ANALOG or BASS_INPUT_TYPE_UNDEF.

On macOS, only the currently enabled input has its volume setting available (if it has a volume control).

Example

List all available input sources, with their current status.

int n;
const char *name;
for (n = 0; name = BASS_RecordGetInputName(n); n++) {
    float vol;
    int s = BASS_RecordGetInput(n, &vol);
    printf("%s [%s : %g]\n", name, s & BASS_INPUT_OFF ? "off" : "on", vol);
}

Find a microphone input.