176 NA EVENT(3)
NAME
NASelectInput, NANextEvent, NACheckMaskEvent, NAMaskEvent, NAPending, NASetPollInterval –
D
event handling for NetAudio clients
ESCRIPTION
These routines provide event handling facilities for connections to a NetAudio audio server. The events
N
generated by the NetAudio server are as follows:
A_SNAPSHOT
When this event is enabled, the server will send a snapshot of the current DAT-Link status
-
v
to the client at regular intervals. The rate of these events can be set with NASetPollInter
al(). For the definition of the snapshot data see the section on NAGetSnapShot() in netau-
N
dio(3).
A_CONFIGURENOTIFY
Whenever the internal status of the server changes an NA_CONFIGURENOTIFY event is
N
sent. The new NAinfo structure can be retrieved using the NAGetInfo() routine.
A_CONFIGUREREQUEST
If this event is unmasked then the client will receive this event whenever any other client
,
t
attempts to change the server settings using NASetInfo(). ( See na_info(3) ) In this case
he server will not act on the change unless the client that received this event acts on the
change by issuing its own NASetInfo() call.
ENA_REMOTEDON
This event is sent after a remote control command completes. The client can execute
t
t
NARemote() and continue immediately. This event can then be used to inform the clien
hat the command has completed. See also na_remote(3).
Routines
#include <netaudio.h>
)
N
int NASelectInput(port,eventMask
Aport ∗port;
int eventMask
This routine informs the server which events are of interest to the calling process. The
e
c
eventMask argument consists of the bit-wise OR of the events that should be passed to th
lient.
int NANextEvent(port,event)
N
NAport ∗port;
Aevent ∗event;
Get the next event from the server that is enabled and store in in event. This routine will wait
i
until an event is received if none are already queued.
nt NACheckMaskEvent(port,eventmask,event)
i
NAport ∗port;
nt eventmask;
;NAevent ∗event
Check if any events that match the given mask are queued. If there are, place the next event
N
in event and return 1. Otherwise return 0.
etAudio Reference Last change: 1992/11/22 1