AFCreateAC(3)							AFCreateAC(3)



NAME
  AFCreateAC, AFChangeACAttributes, AFFreeAC - manipulate audio	contexts

SYNTAX
  #include <AF/AFlib.h>

  AC AFCreateAC	(AFAudioConn *aud, ADevice device, unsigned long valuemask,
					  AFSetACAttributes *attributes)

  void AFChangeACAttributes (AC	ac, unsigned long valuemask,
					  AFSetACAttributes *attributes)

  void AFFreeAC	(AC ac)

ARGUMENTS

  aud	    Specifies the connection to	the audio server.

  device    Specifies the index	of the desired device in the device array as
	    defined  when the connection to the	audio server was opened.

  ac	    Specifies an existing AC.

  valuemask Specifies which attributes in the AC are to	be set or modifed.
	    Its	value is a bitwise inclusive OR	of zero	or more	valid AC com-
	    ponent mask	bits (ACRecordGain, ACPlayGain,	ACPreemption,
	    ACStartTimeout, ACEndSilence, ACEncodingType, ACChannels, and
	    ACEndian).

  attributes
	    Provides any values	specified by the valuemask.

DESCRIPTION
  The AFCreateAC function returns an audio context with	the attributes speci-
  fied by attributes.  The audio context is initialized	with a play and
  record gain of 0 dB, mix mode	(no preempt), whatever channels	and sample
  type are supported by	the device, and	the endian-ness	of the client
  machine.

  AFChangeACAttributes changes the specified components	of the given AC.

  AFFreeAC destroys the	given AC and any associated storage.

BUGS
  The client library should provide some sort of abstract interface for
  obtaining the	device handle.

SEE ALSO
  AFOpenAudioConn(3), AFCreatePhoneAC(3), AAudioDeviceDescriptor(3)
  AF(1)



BUGS
  If you encounter a reproducible bug, please submit a problem report to
  (af-bugs@crl.dec.com).



COPYRIGHT
  Copyright 1990-1994, Digital Equipment Corporation.
  See AF(1) for	a full statement of rights and permissions.

AUTHORS
  Digital Cambridge Research Lab