ALgetconfig(3dm)					      ALgetconfig(3dm)

NAME    [Toc]    [Back]

     ALgetconfig, ALsetconfig -	(obsolete) get/set the ALconfig	structure of
     an	audio ALport structure

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audio.h>

     ALconfig ALgetconfig(ALport port)    [Toc]    [Back]
     int ALsetconfig(ALport port, ALconfig config)

PARAMETER    [Toc]    [Back]

     port     expects an ALport	structure, the returned	value of an
	      ALopenport(3dm) call.

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

DESCRIPTION    [Toc]    [Back]

     ALsetconfig and ALgetconfig are obsolete and are provided for backward
     compatibility. The	preferred functions are	alSetConfig(3dm) and
     alGetConfig(3dm).

     ALgetconfig(3dm) leaves port unchanged, but returns an ALconfig structure
     initialized to the	configuration values of	the audio port.
     ALfreeconfig(3dm) should be called	when the returned ALconfig is no
     longer needed.

     ALgetconfig(3dm) can fail for the following reasons:

     AL_BAD_PORT	 port is either	invalid	or null.

     AL_BAD_OUT_OF_MEM	 insufficient memory is	available to allocate the
			 ALconfig structure.

     ALsetconfig(3dm) changes the configuration	of the audio port, port, to
     match that	described by the ALconfig structure, config.

     ALconfig structures contain information which specifies configuration
     options for a port	such as	queuesize, sample width, and channel setting.

     ALsetconfig(3dm) can fail for the following reasons:

     AL_BAD_PORT       port is either invalid or null.

     AL_BAD_CONFIG     config is either	invalid	or null.

     AL_BAD_DEVICE     port and	config have conflicting	device settings.

     AL_BAD_QSIZE      port and	config have conflicting	values for queue size.






									Page 1






ALgetconfig(3dm)					      ALgetconfig(3dm)



     AL_BAD_CHANNELS   port and	config have conflicting	channels settings.

DIAGNOSTICS    [Toc]    [Back]

     When ALgetconfig(3dm) fails, it returns a null-valued ALconfig.

     Upon successful completion, ALsetconfig(3dm) returns 0. Otherwise,
     ALsetconfig(3dm) returns -1 and sets an error number which	can be
     retrieved using oserror(3C).

NOTE    [Toc]    [Back]

     The device, queue size, and the number of channels	of a port are static
     attributes; they cannot be	changed	once a port is opened.
      If you attempt to	change any of these values, ALsetconfig(3dm) will
     fail.

SEE ALSO    [Toc]    [Back]

     ALfreeconfig(3dm),	ALnewconfig(3dm), ALsetqueuesize(3dm),
     ALsetwidth(3dm), ALsetchannels(3dm), oserror(3C)
alGetConfig(3dm)					      alGetConfig(3dm)

NAME    [Toc]    [Back]

     alGetConfig, alSetConfig -	get/set	the ALconfig of	an audio ALport

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audio.h>

     ALconfig alGetConfig(ALport port)    [Toc]    [Back]
     int alSetConfig(ALport port, ALconfig config)

PARAMETER    [Toc]    [Back]

     port     expects an ALport, the returned value of an alOpenPort(3dm)
	      call.

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

DESCRIPTION    [Toc]    [Back]

     alGetConfig leaves	port unchanged,	but returns an ALconfig	structure
     initialized to the	configuration values of	the audio port.	 alFreeConfig
     should be called when the returned	ALconfig is no longer needed.

     alSetConfig attempts to change the	configuration of the audio port, port,
     to	match that described by	the ALconfig structure,	config.

     ALconfig structures contain information which specifies configuration
     options for a port	such as	queue size, sample width, and number of
     channels.

DIAGNOSTICS    [Toc]    [Back]

     When alGetConfig fails, it	returns	a null-valued ALconfig.

     alGetConfig can fail for the following reasons:

     AL_BAD_PORT	 port is either	invalid	or null.

     AL_BAD_OUT_OF_MEM	 insufficient memory is	available to allocate the
			 ALconfig structure.

     Upon successful completion, alSetConfig returns 0.	Otherwise, alSetConfig
     returns -1	and sets an error number which can be retrieved	using
     oserror(3C).

     alSetConfig can fail for the following reasons:

     AL_BAD_PORT       port is either invalid or null.

     AL_BAD_CONFIG     config is either	invalid	or null.

     AL_BAD_DEVICE     port and	config have conflicting	device settings.






									Page 1






alGetConfig(3dm)					      alGetConfig(3dm)



     AL_BAD_QSIZE      port and	config have conflicting	values for queue size.

     AL_BAD_CHANNELS   port and	config have conflicting	number of channels.

NOTE    [Toc]    [Back]

     The device, queue size, and the number of channels	of a port are static
     attributes; they cannot be	changed	once a port is opened.
      If you attempt to	change any of these values, alSetConfig	will fail.

SEE ALSO    [Toc]    [Back]

     alFreeConfig(3dm),	alNewConfig(3dm), alSetQueueSize(3dm),
     alSetWidth(3dm), alSetChannels(3dm), alSetDevice(3dm), oserror(3C)


									PPPPaaaaggggeeee 2222