Name

       AuSoundRecord - create a flow to record audio to any destination.

Synopsis

       #include <audio/audiolib.h>
       #include <audio/soundlib.h>

       AuEventHandlerRec  *AuSoundRecord(server,  source,  gain,  num_samples,  mode, sound_data,
       flow, volume_mult_elem, status)
           AuServer *server;
           AuDeviceID source;
           AuFixedPoint gain;
           AuUint32 num_samples;
           int mode;
           AuSoundDataPtr sound_data;
           AuFlowID *flow; /* RETURN */
           int *volume_mult_elem; /* RETURN */
           AuStatus *status; /* RETURN */

Arguments

       server    Specifies the connection to the audio server.

       source    Specifies the input device to use.

       gain      Specifies the gain for the input device.

       num_samples
                 Specifies the number of samples to record.

       mode      Specifies the line mode for the input  device.   Currently  the  following  line
                 modes     are     defined:    AuDeviceInputModeNone,    AuDeviceInputModeLineIn,
                 AuDeviceInputModeMicrophone.

       sound_data
                 Specifies the sound information.

       flow      If non-NULL, returns the flow ID.

       volume_mult_elem
                 Accord to the comment in the source, not implemented.

       status    If non-NULL, flush the output buffer and return the status from the server.

Description

       AuSoundRecord creates a flow to record audio from source to any destination and returns  a
       pointer  to  the  event  handler  created  or  NULL  if there was an error. The sound_data
       structure contains the necessary information about the audio format and the data  handling
       function.

Errors

       AuBadDevice.

See Also

       AuSoundRecordToBucket, AuSoundRecordToData, AuSoundRecordToFile, AuSoundRecordToFileN.

       audiolib - Network Audio System C Language Interface