# EnableAudioInput

Enable Anvil audio input.

### Synopsis

`Err EnableAudioInput (int32 OnOrOff, TagArg *tagList)
Err EnableAudioInputVA (int32 OnOrOff, uint32 tag1, ...)`

### Description

Enables or disables the use of audio input on systems that have audio input capability (e.g. Anvil systems) for the calling task. The DSP instrument directin.dsp requires that a successful call to enable audio input be made before that instrument can be loaded.

Enable/Disable calls nest.

If you turn on audio input, you do not need to turn it off as part of your cleanup.

### Arguments

OnOrOff
  Non-zero to enable, zero to disable. An enable count is maintained for each task so that you may nest calls to EnableAudioInput (TRUE, ...).

### Tags

None

### Return Value

The function returns a non-negative value if successful or an error code (a negative value) if an error occurs.

### Implementation

SWI implemented in Audio folio V24.

### Caveats

The use of audio input may require a special licensing agreement. `EnableAudioInput()` only permits a NULL tag list pointer. Therefore, `EnableAudioInputVA()` always fails with AF_ERR_BADTAG.

### Associated Files

audio.h

### See Also

``directin.dsp``