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  at‐
23                 tributes  argument.   This  must be a bitwise inclusive OR of
24                 zero or more of these constants: AuCompCommonIDMask,  AuComp‐
25                 CommonKindMask,  AuCompCommonUseMask, AuCommonFormatMask, Au‐
26                 CommonNumTracksMask, AuCommonAccessMask, AuCommonDescription‐
27                 Mask,  AuCompDeviceMinSampleRateMask, AuCompDeviceMaxSampleR‐
28                 ateMask, AuCompDeviceLocationMask, AuCompDeviceGainMask,  Au‐
29                 CompDeviceLineModeMask,  AuCompDeviceChildrenMask,  or AuCom‐
30                 pDeviceMasks.  If valuemask is zero, the attributes  are  ig‐
31                 nored 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.5                    AuListDevices(3)
Impressum