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, 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, AuCom-
	       pCommonUseMask, AuCommonFormatMask, AuCommonNumTracksMask, AuCom-
	       monAccessMask,  AuCommonDescriptionMask,  AuCompDeviceMinSampleR-
	       ateMask, AuCompDeviceMaxSampleRateMask, AuCompDeviceLocationMask,
	       AuCompDeviceGainMask, AuCompDeviceLineModeMask, AuCompDeviceChil-
	       drenMask, or AuCompDeviceMasks.	If valuemask is  zero,	the  at-
	       tributes are ignored and are not referenced.

     attributesSpecifies  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.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+15.1.quarterly>

home | help