afInitInstIDs(3dm) afInitInstIDs(3dm)
afInitInstIDs - specify a list of instrument parameter chunk identifiers
to be stored in an AFfilesetup structure.
#include <dmedia/audiofile.h>
void afInitInstIDs(AFfilesetup setup, int instids[], int ninsts)
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.
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.
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.
afNewFileSetup(3dm), afOpenFile(3dm), afGetInstIDs(3dm)
afInitInstIDs(3dm) afInitInstIDs(3dm)
afInitInstIDs - specify a list of instrument parameter chunk identifiers
to be stored in an AFfilesetup structure.
#include <dmedia/audiofile.h>
void afInitInstIDs(AFfilesetup setup, int instids[], int ninsts)
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.
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.
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.
afNewFileSetup(3dm), afOpenFile(3dm), afGetInstIDs(3dm)
PPPPaaaaggggeeee 1111 [ Back ]
|