Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
AuListDevices(3)	   Library Functions Manual	      AuListDevices(3)

Name
       AuListDevices - list devices

Synopsis
       #include	<audio/audiolib.h>

       AuDeviceAttributes  *AuListDevices(server,  valuemask, attributes, nde-
       vices, 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  attrib-
		 utes  argument.   This	must be	a bitwise inclusive OR of zero
		 or more of these  constants:  AuCompCommonIDMask,  AuCompCom-
		 monKindMask,  AuCompCommonUseMask, AuCommonFormatMask,	AuCom-
		 monNumTracksMask,  AuCommonAccessMask,	  AuCommonDescription-
		 Mask,	AuCompDeviceMinSampleRateMask, AuCompDeviceMaxSampleR-
		 ateMask, AuCompDeviceLocationMask, AuCompDeviceGainMask,  Au-
		 CompDeviceLineModeMask,  AuCompDeviceChildrenMask,  or	AuCom-
		 pDeviceMasks.	If valuemask is	zero, the attributes  are  ig-
		 nored 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  mem-
       ory in the list when its	nolonger needed.

Errors
       AuBadLength.

See Also
       AuGetDeviceAttributes.

       audiolib	- Network Audio	System C Language Interface

audiolib - device attributes	     1.9.4		      AuListDevices(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=AuListDevices&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help