1AuListDevices(3)           Library Functions Manual           AuListDevices(3)
2
3
4

Name

6       AuListDevices - list devices
7

Synopsis

9       #include <audio/audiolib.h>
10
11       AuDeviceAttributes  *AuListDevices(server,  valuemask, attributes, nde‐
12       vices, status)
13           AuServer *server;
14           AuMask valuemask;
15           AuDeviceAttributes *attributes;
16           int *ndevices; /* RETURN */
17           AuStatus *status; /* RETURN */
18

Arguments

20       server    Specifies the connection to the audio server.
21
22       valuemask Specifies  which  device  attributes  are  defined   in   the
23                 attributes  argument.  This must be a bitwise inclusive OR of
24                 zero or more of these constants: AuCompCommonIDMask,  AuComp‐
25                 CommonKindMask,    AuCompCommonUseMask,   AuCommonFormatMask,
26                 AuCommonNumTracksMask,  AuCommonAccessMask,  AuCommonDescrip‐
27                 tionMask,  AuCompDeviceMinSampleRateMask, AuCompDeviceMaxSam‐
28                 pleRateMask, AuCompDeviceLocationMask,  AuCompDeviceGainMask,
29                 AuCompDeviceLineModeMask, AuCompDeviceChildrenMask, or AuCom‐
30                 pDeviceMasks.  If  valuemask  is  zero,  the  attributes  are
31                 ignored and are not referenced.
32
33       attributes
34                 Specifies  the  structure from which the values (as specified
35                 by the value mask) are to be taken.
36
37       ndevices  Returns the number of devices in the returned list.
38
39       status    If non-NULL, flush the output buffer and  return  the  status
40                 from the server.
41

Description

43       AuListDevices  returns  a  list of devices whose attributes match those
44       values in attributes specified by valuemask, or NULL, with ndevices set
45       to  0, if there was an error.  Use AuFreeDeviceList to release the mem‐
46       ory in the list when its nolonger needed.
47

Errors

49       AuBadLength.
50

See Also

52       AuGetDeviceAttributes.
53
54       audiolib - Network Audio System C Language Interface
55
56
57
58audiolib - device attributes         1.9.1                    AuListDevices(3)
Impressum