afInitTrackIDs(3dm)                                        afInitTrackIDs(3dm)



NAME
     afInitTrackIDs - initialize the list of audio track identifiers in an
     AFfilesetup structure.

SYNOPSIS
     #include <dmedia/audiofile.h>

     void afInitTrackIDs(AFfilesetup setup, int trackids[], int ntracks)

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

     trackids   is an array of positive integer id's which are handles for
                audio tracks in a new file after it is opened with write
                access.

                Since all currently supported file formats contain only one
                audio track, the trackids array should always contain one ID,
                AFDEFAULTTRACK.

     ntracks    The number of audio tracks in the file configuration.  For all
                currently supported file formats, ntracks is always 1.

DESCRIPTION
     afInitTrackIDs() initializes a list of unique track ID's which provide
     handles to the tracks in a new audio file after it is created by passing
     setup to afOpenFile(3dm).

     afInitTrackIDs() is a placeholder routine for now, since any value for
     ntracks other than 1, and any value for trackids other than
     {AFDEFAULTTRACK} will be ignored for all currently supported audio file
     formats.  Note that the Audio File Library will continue to support
     additional file formats, and so it is likely that multiple-track formats
     will be supported in the future.  See afGetTrackIDs(3dm) for more
     information.

SEE ALSO
     afNewFileSetup(3dm), afOpenFile(3dm), afInitTrackIDs(3dm),
     afGetTrackIDs(3dm)















                                                                        Page 1