debian man page for aulistdevices

AuListDevices(3)					     Library Functions Manual						  AuListDevices(3)

Name
       AuListDevices - list devices

Synopsis
       #include <audio/audiolib.h>

       AuDeviceAttributes *AuListDevices(server, valuemask, attributes, ndevices, status)
	   AuServer *server;
	   AuMask valuemask;
	   AuDeviceAttributes *attributes;
	   int *ndevices; /* RETURN */
	   AuStatus *status; /* RETURN */

Arguments
       server	 Specifies the connection to the audio server.

       valuemask Specifies which device attributes are defined in the attributes argument.  This must be a bitwise inclusive OR of zero or more of
		 these constants: AuCompCommonIDMask, AuCompCommonKindMask, AuCompCommonUseMask, AuCommonFormatMask, AuCommonNumTracksMask, AuCom-
		 monAccessMask,  AuCommonDescriptionMask,  AuCompDeviceMinSampleRateMask, AuCompDeviceMaxSampleRateMask, AuCompDeviceLocationMask,
		 AuCompDeviceGainMask, AuCompDeviceLineModeMask, AuCompDeviceChildrenMask,  or	AuCompDeviceMasks.   If  valuemask  is	zero,  the
		 attributes are ignored and are not referenced.

       attributes
		 Specifies the structure from which the values (as specified by the value mask) are to be taken.

       ndevices  Returns the number of devices in the returned list.

       status	 If non-NULL, flush the output buffer and return the status from the server.

Description
       AuListDevices  returns  a  list of devices whose attributes match those values in attributes specified by valuemask, or NULL, with ndevices
       set to 0, if there was an error.  Use AuFreeDeviceList to release the memory in the list when its nolonger needed.

Errors
       AuBadLength.

See Also
       AuGetDeviceAttributes.

       audiolib - Network Audio System C Language Interface

audiolib - device attributes					       1.9.3							  AuListDevices(3)