AChoosePlayAttributes(3X)

NAME

AChoosePlayAttributes − select hardware-supported attributes to use when playing an existing file or a stream

SYNOPSIS

#include <audio/Alib.h>

void

AChoosePlayAttributes (

Audio *audio,

AudioAttributes *src_attributes,

AudioAttrMask user_mask,

AudioAttributes * attributes,

AByteOrder *byte_order,

long *status_return

);

DESCRIPTION

AChoosePlayAttributes() selects hardware-supported attributes to use when playing an existing file or a stream.

audio Specifies the Audio structure associated with this connection.

src_attributes Specifies the audio attributes of the source stream.

user_mask Specifies which of the audio attributes in the attributes structure have been supplied by the user (mask bit set to 1). These attributes are checked for validity, but are not changed.

attributes Contains user-supplied attributes (if any) as indicated by user_mask. AChoosePlayAttributes Writes appropriate values to those attributes not supplied by the user.

byte_order Receives the byte ordering for hardware.

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

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

AUTHOR

AChoosePlayAttributes() was developed by HP.

Museum