Function VTCompressionSessionGetTimeRangesForNextPass

pub unsafe extern "C-unwind" fn VTCompressionSessionGetTimeRangesForNextPass(
    session: &VTCompressionSession,
    time_range_count_out: NonNull<CMItemCount>,
    time_range_array_out: NonNull<*const CMTimeRange>,
) -> i32

Available on crate features VTCompressionSession and objc2-core-media only.

Retrieves the time ranges for the next pass.

If VTCompressionSessionEndPass sets *furtherPassesRequestedOut to true, call VTCompressionSessionGetTimeRangesForNextPass to find out the time ranges for the next pass. Source frames outside these time ranges should be skipped. Each time range is considered to include any frame at its start time and not to include any frame at its end time. It is an error to call this function when multi-pass encoding has not been enabled by setting kVTCompressionPropertyKey_MultiPassStorage, or when VTCompressionSessionEndPass did not set *furtherPassesRequestedOut to true.

Parameter timeRangeCountOut: Points to a CMItemCount to receive the number of CMTimeRanges.

Parameter timeRangeArrayOut: Points to a const CMTimeRange * to receive a pointer to a C array of CMTimeRanges. The storage for this array belongs to the VTCompressionSession and should not be modified. The pointer will be valid until the next call to VTCompressionSessionEndPass, or until the VTCompressionSession is invalidated or finalized.