MPEG sample auxiliary information functions

MP4SetupSampleAuxiliaryInformation

ISOErr MP4SetupSampleAuxiliaryInformation ( 
            MP4Media theMedia, 
            u8 isUsingAuxInfoPropertiesFlag,
            u32 aux_info_type, 
            u32 aux_info_type_parameter,
            u8 default_sample_info_size );

This function can be used to setup and initialize sample auxiliary information for a track. It must be called before adding sample auxiliary data. It can be called multiple times with different type, parameter combinations to setup multiple sample auxiliary information for a single track. To add sample auxiliary data for a sample use MP4AddSampleAuxiliaryInformation.

isUsingAuxInfoPropertiesFlag Indicates whether aux_info_type and aux_info_type_parameter are used for setting up auxiliary information.

aux_info_type Set this properly according to the specification.

aux_info_type_parameter Set this properly according to the specification.

default_sample_info_size If not equal to zero, all data for sample auxiliary information must be the given size.

MP4AddSampleAuxiliaryInformation

ISOErr MP4AddSampleAuxiliaryInformation ( 
            MP4Media theMedia, 
            u8 isUsingAuxInfoPropertiesFlag, 
            u32 aux_info_type, 
            u32 aux_info_type_parameter,
            MP4Handle dataH,
            u32 sampleCount,
            MP4Handle sizesH );

This function can be used to add sample auxiliary information data for a range of samples. The first three parameters are used to identify the type of sample auxiliary information. Note that before adding data, MP4SetupSampleAuxiliaryInformation has to be called with the same parameters.

MP4GetSampleAuxiliaryInformation

ISOErr MP4GetSampleAuxiliaryInformation( 
            MP4Media theMedia, 
            u32 *outCount, 
            MP4Handle isUsingAuxInfoPropertiesFlags,
            MP4Handle aux_info_types, 
            MP4Handle aux_info_type_parameters );

This function can be used to get information about all sample auxiliary information for a track. The outCount parameter will contain the number of different sample auxiliary information. The MP4Handles will contain an array of u8 and u32, which will represent the description of each instance of sample auxiliary information inside a track.

MP4GetSampleAuxiliaryInformationForSample

ISOErr MP4GetSampleAuxiliaryInformationForSample( 
            MP4Media theMedia, 
            u8 isUsingAuxInfoPropertiesFlag, 
            u32 aux_info_type, 
            u32 aux_info_type_parameter,
            u32 sampleNr, 
            MP4Handle outDataH, 
            u32 *outSize );

This function can be used to get the sample auxiliary information data for a specific sample and type.