man3/AFFreeAC.3

#

    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