ACalculateLength(3X)

NAME

ACalculateLength − return the size in bytes of converted data

SYNOPSIS

#include <audio/Alib.h>

long ACalculateLength (

Audio *audio,

long buffer1_size,

AudioAttributes *buffer1_attributes,

AudioAttributes *buffer2_attributes,

long *status_return);

DESCRIPTION

ACalculateLength() returns the size in bytes of the data in buffer 1 after it is converted to the attributes of buffer2_attributes.

audio specifies the Audio structure associated with this connection.

buffer1_size specifies the length in bytes of the data in buffer 1.

buffer1_attributes specifies the attributes of the data in buffer 1.

buffer2_attributes specifes the attributes of the data in buffer 2.

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

RETURN VALUE

Upon successful completion, ACalculateLength() returns the size in bytes of the data which will be produced by converting a source buffer whose size in bytes is specified in buffer1_size and whose attributes are specified in buffer1_attributes to the attributes specifed in buffer2_attributes.

ERRORS

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

0 AENoError

EXAMPLE

For an example, see /usr/audio/examples/splayer.c

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 installed. To find out whether or not your system has audio hardware, refer to the hardware manual that accompanies your system.

AUTHOR

ACalculate Length() was developed by HP.

Museum