NAME

ASelectInput − request report of specified audio events

SYNOPSIS

void ASelectInput(

Audio *audio,
ATransID xid,
AEventMask event_mask,
long *status_return

);

DESCRIPTION

ASelectInput() requests the report of the audio events specified by the event mask. 

audio is the Audio structure associated with this connection. 

xid specifies the ID of the transaction whose events are of interest. 

event_mask specifies the events for which a report is requested.  Each bit in the mask corresponds to one type of audio event.  The mask is the bitwise inclusive OR of the masks for the individual event types. 

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

ERRORS

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

0 AENoError

2 AEBadAudio

3 AEBadValue

EXAMPLES

The following example sets the event mask to request record monitor and transaction pause events, and sets up status_return to receive an error status. 

Audio *audio;        /* audio connection */
TransID xid;         /* transaction ID */
AEventMask emask;    /* event mask */
long status;         /* error status */
.
.
.
/* request input event reports */
emask = (AETRecordMonitor | AETransPaused)
ASelectInput(audio, xid, emask, &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

ASelectInput() was developed by HP. 

SEE ALSO

ACheckEvent(3X), ACheckMaskEvent(3X), AEventsQueued(3X), AMaskEvent(3X), ANextEvent(3X), APeekEvent(3X), APutBackEvent(3X), AQlength(3X). 

Using the Audio Application Program Interface.

Hewlett-Packard Company  —  HP-UX Release 9.03: April 1994