ASetupConversion(3X)

NAME

ASetupConversion − perform setup required for stream data conversion

SYNOPSIS

#include <audio/Alib.h> AConvertParams*
ASetupConversion (

Audio * audio,

AudioAttributes * src_attributes,

AByteOrder * src_byte_order,

AudioAttributes * dest_attributes,

AByteOrder * dest_byte_order,

long * status_return);

DESCRIPTION

ASetupConversion() performs initialization for stream data conversion. The user specifies the source stream attributes and byte order and the desired destination stream attributes. ASetupConversion returns a pointer to an AConvertParams structure, which will be used by AConvertBuffer to perform the stream conversion.

audio specifies the Audio structure associated with this connection.

src_attributes specifies the attributes of the source stream.

src_byte_order specifies the byte ordering of the source stream.

dest_attributes specifies the attributes of the destination stream.

dest_byte_order specifies the byte ordering of the destination stream.

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

RETURN VALUE

Upon successful completion, ASetupConversion() returns a pointer to the conversion parameter structure AConvertParams. To free the space allocated for this structure, use AEndConversion.

ERRORS

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

0 AENoError

17 AEOutOfMemory

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

AUTHOR

ASetupConversion() was developed by HP.

Museum

Related Articles