ABestAudioAttributes(3X) — Series 700 Only

NAME

ABestAudioAttributes − get best audio attribute setting for specified controller

SYNOPSIS

#include <audio/Alib.h>

AudioAttributes *ABestAudioAttributes (Audio *audio);

DESCRIPTION

ABestAudioAttributes() returns a pointer to an AudioAttributes structure containing the optimal attributes for the audio controller associated with the audio connection. The application can use the returned attributes pointer directly in subsequent audio operation calls.

Changes should not be made to the AudioAttributesstructure; rather, the application should copy the structure and make changes in the copy, as shown in the example below.

audio specifies the Audio structure associated with this connection.

RETURN VALUE

Upon successful completion, ABestAudioAttributes() returns a pointer to an AudioAttributes structure.

ERRORS

ABestAudioAttributes() does not return an error status.

EXAMPLES

The following example shows a call to ABestAudioAttributes() to get the pointer to the best audio attributes.

Audio *audio; /* audio connection */"
AudioAttributes *bestAttr; /* best attributes */"
.
.
.
/* get best audio attributes */
bestAttr = ABestAudioAttributes (audio);

This example shows how to get a copy of the best attributes and make a change to a field in the copy. The program assigns the contents at the returned pointer (the audio attributes) to myAttr and then sets the value of the sampled_attr field in myAttr to ASAFBitPerSample.

Audio *audio; /* audio connection */
AudioAttributes myAttr; /* my copy of best attributes */
.
.
.
/* get copy of audio attributes; change the copy */
myAttr = *ABestAudioAttributes (audio);
myAttr.attr.sampled_attr.data_format = ADFALaw

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

ABestAudioAttributes() was developed by HP.

Museum