NextAudioFileRegion

Finds the next audio file region in a region list.

Declaration

#define NextAudioFileRegion (inAFRegionPtr) (
   (AudioFileRegion*) ((char*) (inAFRegionPtr) +
   offsetof(AudioFileRegion, mMarkers) +
   ((inAFRegionPtr)->mNumberMarkers) * sizeof (AudioFileMarker))
)

Parameters

inAFRegionPtr

A pointer to an audio file region in the region list.

Return Value

A pointer to the next region after the region pointed to by the inAFRegionPtr parameter. This value can be beyond the end of the list, so pay attention to the total number of regions in the list.

Overview

Because audio file regions are of variable length, you cannot easily walk the list. Use this convenience function when you call the AudioFileGetProperty function with the kAudioFilePropertyRegionList property to walk through the list of regions returned.

See Also

Audio File Macros

NumBytesToNumAudioFileMarkers

A macro that returns the number of audio file markers represented by a specified number of bytes.

NumAudioFileMarkersToNumBytes

A macro that returns the number of bytes corresponding to a specified number of audio file markers.