182 NETAUDIO(3)
NAME
NAOpen, NAOpenData, NAClose, NACloseData, NAGetSnapShot, NAPause, NABegin, NADrain,
,
N
NAFlush, NASetFilter, NASerialRead, NASerialWrite, NAGetServerVersion, NAServer
APauseServer, NAResumeServer, NAWrite, NARead – library routines for client side NetAudio calls
DESCRIPTION
These routines allow C programs to access a NetAudio server on the local machine or other machines
t
connected via a network to playback and record audio signals. These routines create a connection to
he NetAudio server, netaudiod(8), and perform the required functions.
ROUTINES
#include <netaudio.h>
)
c
NAport ∗NAOpen(server
onst char ∗server;
Open a connection to the NetAudio server specified by the server string. This string should be
-
m
of the form host:unit, where host is the host on which the server is running and unit deter
ines which server on that host to connect to. If server is null, then the environment variable
A is queried for the server string. If that is also null, then the local host is usedUDIO_DEVICE
T
with unit 0.
he return value is an opaque pointer which is used for other calls to NetAudio routines. A
i
return value of NULL indicates there was an error in opening the connection.
nt NAOpenData(port,playrec)
i
NAport ∗port;
nt playrec;
Adds a data connection to a previously open NAport. The playrec arguments should be
r
N or to open the connection for playback (from client to server) oA_PLAY NA_RECORD
record (server to client) respectively. The server provides exclusive access to data
a
c
connections--only one client may have a data connection open at any time. Attempts to open
onnection to a server that already has a data connection will result in a return value of -1 with
eerrno set to connection to the server. (Though this fil
EACCES. Otherwise, the return value is
.
i
descriptor will normally not be used by user programs)
nt NACloseData(port,force)
i
NAport ∗port;
nt force;
Close the data connection on the given port. If force is non-zero then pending data will be
s
t
immediately flushed. Otherwise, the data connection will be closed after all queued data i
ransferred to the DAT-Link as if NADrain() had been called first. In this case, the return
i
value will the same as described for NADrain().
nt NAClose(port)
NAport ∗port;
Close the connection to the given port. If a data connection is open, it is also closed and all
i
queued data is immediately flushed.
nt NAGetSnapshot(port,snap)
N
NAport ∗port;
Asnapshots ∗snap;
Get a NAsnapshots structure from the server. This structure contains the fast-changing status
t
within the server:
ypedef struct {
float VULevelLeft; /∗ Current VU levels ∗/
1NetAudio Reference Last change: 1993/11/11