alGetDevice(3dm)					      alGetDevice(3dm)

NAME    [Toc]    [Back]

     alSetDevice, alGetDevice -	get/set	the device setting in an audio
     ALconfig structure

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audio.h>

     int alGetDevice(ALconfig config)

     int alSetDevice(ALconfig config, int device)

PARAMETER    [Toc]    [Back]

     config   expects an ALconfig structure, the returned value	of a call to
	      alNewConfig(3dm) or alGetConfig(3dm).

     device   expects the integer resource ID of an audio device (see
	      alResources(3dm)).

DESCRIPTION    [Toc]    [Back]

     alSetDevice sets the device setting in the	ALconfig structure config.
     Any audio port that you then open using config will attempt to use	the
     device you	specify.

     alGetDevice returns the current device setting in the ALconfig structure
     config. Note that since device connections	are dynamic, ports previously
     opened with this ALconfig may no longer be	connected to the given device.

DIAGNOSTICS    [Toc]    [Back]

     If	successful, alGetDevice	returns	a positive device resource ID.
     Otherwise,	alGetDevice returns -1 and and sets an error number which can
     be	retrieved with oserror(3C).

     alGetDevice can fail for the following reason:

     AL_BAD_CONFIG   config is invalid or null.

     If	successful, alSetDevice	returns	0. Otherwise, it returns -1 and	sets
     an	error number which can be retrieved with oserror(3C).

     alSetDevice can fail for the following reasons:

     AL_BAD_CONFIG   config is invalid or null.

     AL_BAD_DEVICE   device is invalid.	Note that even though alSetDevice may
		     succeed in	setting	a given	device in an ALconfig, the
		     ensuing alOpenPort	may still fail if the device does not
		     exist.

SEE ALSO    [Toc]    [Back]

     alNewConfig(3dm), alGetConfig(3dm), alOpenPort(3dm), alSetConfig(3dm),
     oserror(3C)


									PPPPaaaaggggeeee 1111