afInitInstIDs(3dm)                                          afInitInstIDs(3dm)


NAME
     afInitInstIDs - specify a list of instrument parameter chunk identifiers
     to be stored in an AFfilesetup structure.

SYNOPSIS
     #include <dmedia/audiofile.h>

     void afInitInstIDs(AFfilesetup setup, int instids[], int ninsts)

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

     instids   is an array of positive integer ID's which are used to
               reference instrument configurations in a file after it is
               created by afOpenFile(3dm).

     ninsts    is the number of instrument configurations requested in setup.

               For AIFF-C (AIFF), this number should be either 0 or 1.  The
               various other file formats supported by the Audio File Library
               have different support different numbers of instrument
               configurations.  Applications should use the afQuery(3dm)
               mechanism to determine the number of supported configurations
               for a given file format.

DESCRIPTION
     afInitInstIDs() initializes a list of unique instrument ID's which are
     used to reference the instrument configurations in a new audio file after
     it is created by a call to afOpenFile(3dm).

     If you set ninsts to 0, afInitInstIDs() will ignore the instids argument,
     so instids can be a null pointer in this case.

CAVEATS
     The Audio File Library will continue to expand the number of supported
     file formats.  The ability of these file formats to store various kinds
     of instrument chunks and instrument parameters will vary.  See
     afGetInstIDs(3dm) for some important notes about handling this situation.

SEE ALSO
     afNewFileSetup(3dm), afOpenFile(3dm), afGetInstIDs(3dm)


                                                                        Page 1