AuSoundRecordToFileN: None

\fBName\fP

AuSoundRecordToFileN -

\fBSynopsis\fP

#include <audio/audiolib.h>

#include <audio/soundlib.h>

AuEventHandlerRec *AuSoundRecordToFileN(server, filename, source, gain, num_samples, callback, callback_data, mode, file_format, comment, rate, data_format, flow, volume_mult_elem, status)

    AuServer *server;

    char *filename;

    AuDeviceID source;

    AuFixedPoint gain;

    AuUint32 num_samples;

    void (*callback)(AuServer *, AuEventHandlerRec *, AuEvent *, AuPointer);

    AuPointer callback_data;

    int mode;

    int file_format;

    char * comment;

    AuUint32 rate;

    int data_format;

    AuFlowID *flow;

    int *volume_mult_elem;

    AuStatus *status;

\fBArguments\fP

server: Specifies the connection to the audio server.
filename: Specifies the name of the file to record to.
source: Specifies the input device to record from.
gain: Specifies the gain for the input device.
num_samples: Specifies the number of samples to record. Use AuUnlimitedSamples to record an unlimited number of samples.
callback: Specifies the procedure to be called for additional event processing.
callback_data: Specifies any additional arguments to be passed to callback.
mode: Specifies the line mode for the input device. Currently the following line modes are defined: AuDeviceInputModeNone, AuDeviceInputModeLineIn, AuDeviceInputModeMicrophone.
file_format: Specifies the file format. Currently, the following file formats are supported: SoundFileFormatSnd, SoundFileFormatVoc, SoundFileFormatWave, SoundFileFormatAiff, SoundFileFormatSvx.
comment: Specifies a comment to embedded in the file.
rate: Specifies the sample rate to record at.
data_format: Specifies the data format. Currently, the following data formats are defined: AuFormatULAW8, AuFormatLinearUnsigned8, AuFormatLinearSigned8, AuFormatLinearSigned16MSB, AuFormatLinearUnsigned16MSB, AuFormatSignedLinear16LSB, and AuFormatLinearUnsigned16LSB.
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.

\fBDescription\fP

AuSoundRecordToFileN creates a flow to record from source into filename and returns a pointer to the event handler created or NULL if there was an error.

\fBErrors\fP

AuBadDevice.

\fBSee Also\fP

AuSoundRecord, AuSoundRecordToBucket, AuSoundRecordToData, AuSoundRecordToFile.

audiolib - Network Audio System C Language Interface