ARecordAData(3X) — Series 700 Only

NAME

ARecordAData − read audio data into sound bucket

SYNOPSIS

#include <audio/Alib.h>

ATransID ARecordAData (

Audio *audio,

SBucket *sb,

SBRecordParams *rp,

long *status_return

);

DESCRIPTION

ARecordAData() reads audio data from the specified server connection into the specified sound bucket and returns a transaction ID. ARecordAData() does not block until the record is complete, and so it can not be followed immediately by a call to ASaveSBucket(). See ASaveSBucket(3X) for suggested program actions.

audio specifies the Audio structure associated with this connection.

sb specifies the sound bucket to receive the data.

rp specifies the record parameters associated with the record operation.

status_return receives the returned status of the operation, unless it is set to NULL.

RETURN VALUE

Upon successful completion, ARecordAData() returns the transaction ID.

ERRORS

If status_return is not set to NULL, one of the following is returned in status_return:

0 AENoError

2 AEBadAudio

10 AEBadGainMatrix

20 AEBadSoundBucket

EXAMPLES

The following example reads data from the connection associated with audio into the sound bucket specified by sb and returns a transaction ID.

TransID xid; /* transID */
Audio *audio;           /* audio connection */
SBucket *sb;           /* sound bucket*/
SBRecordParams rparams; /* record parameters */
long status;            /* error status */
.
.
.
/* start record transaction */
xid = ARecordAData(audio, sb, &rparams, &status);

DEPENDENCIES

This function belongs to the Audio Library of functions that manage connections to an audio server. The audio server must run on a system that has audio hardware. To find out whether or not your system has audio hardware, refer to the hardware manual that accompanies your system.

AUTHOR

ARecordAData() was developed by HP.

Museum

Related Articles