afInitTrackIDs(3dm)afInitTrackIDs(3dm)NAMEafInitTrackIDs - 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.
DESCRIPTIONafInitTrackIDs() 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 ALSOafNewFileSetup(3dm), afOpenFile(3dm), afInitTrackIDs(3dm),
afGetTrackIDs(3dm)
Page 1
