Retrieving NITO Metadata from a NITO File

The Fetch NITO Metadata API is a non-safety API that allows the user to retrieve NITO metadata from the parameter sets present in a NITO file. Depending on the workflow, NITO metadata can be helpful in use cases such as validation. One example can be confirming that the same NITO is used during initial frame capture and at a later stage (such as ISP processing).

A NITO file may contain one or more "parameter sets", and each parameter set contains "NITO metadata", defined as the parameter set ID, parameter set schema hash, and parameter set data hash unique to that parameter set. This API provides the ability to fetch this metadata for each parameter set in a NITO file.

The API consists of a single standalone function (see below), with an associated struct type and constants specific to a NITO file (described in the following section):

SIPLStatus GetNitoMetadataFromMemory(
    uint8_t const *const nitoMem, 
    size_t const nitoMemLength, 
    NvSIPLNitoMetadata *const metadataArray, 
    size_t const metadataArrayLength, 
    size_t *const metadataCount)