Na Event - Townshend Computer Tools DAT-Link User Manual

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

NA EVENT(3)

-
,
t
e
1