afInitAESChannelData(3dm)                            afInitAESChannelData(3dm)


NAME
     afInitAESChannelData, afInitAESChannelDataTo - set a flag in an
     AFfilesetup so that storage space for AES channel status data is reserved
     in / removed from a file.

SYNOPSIS
     #include <dmedia/audiofile.h>

     void afInitAESChannelData(AFfilesetup setup, int track)

     void afInitAESChannelDataTo(AFfilesetup setup, int track,
                                 int usedata)

PARAMETER
     setup   is an AFfilesetup structure, previously created by a call to
             afNewFileSetup(3dm).

     track   is an integer identifier which identifies an audio track in
             setup.  For now, the constant value AF_DEFAULT_TRACK should
             always be used for this argument.

     usedata is a flag indicating whether AES data will be stored in the
             file.

DESCRIPTION
     afInitAESChannelData() sets a flag in an AFfilesetup structure which
     indicates that space should be reserved for 24 AES channel status bytes.

     It is necessary to allocate header space by calling
     afInitAESChannelData() before afOpenFile(3dm) in order to store AES
     channel status information for a track by calling afSetAESChannelData().

     afInitAESChannelDataTo is designed to replace the older
     afInitAESChannelData.  This new routine allows a user to remove AES data
     storage from a file by setting usedata to 0.

CAVEATS
     This function will always manipulate data that is to be interpreted as
     AES channel status data, but there is never any guarantee that such data
     will be present in a given input file or not, or will be allowed in a
     given output file or not (unless the file format of the file being read
     or written requires that AES data is always present).  In the currently
     supported file formats which allow AES data (AIFF and AIFF-C), the
     presence of AES channel status data is optional.

SEE ALSO
     afNewFileSetup(3dm), afOpenFile(3dm), afSetAESChannelData(3dm),
     afInitAESChannelDataTo(3dm)


                                                                        Page 1