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, ...).

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