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,
                AF_DEFAULT_TRACK.

     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
     {AF_DEFAULT_TRACK} 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