Function VTCompressionSessionEndPass

Source
pub unsafe extern "C-unwind" fn VTCompressionSessionEndPass(
    session: &VTCompressionSession,
    further_passes_requested_out: *mut u8,
    reserved: *mut u32,
) -> i32
Available on crate feature VTCompressionSession only.
Expand description

Call to announce the end of a pass.

VTCompressionSessionEndPass can take a long time, since the video encoder may perform significant processing between passes. VTCompressionSessionEndPass will indicate via the furtherPassesRequestedOut argument whether the video encoder would like to perform another pass. There is no particular bound on the number of passes the video encoder may request, but the client is free to disregard this request and use the last-emitted set of frames. It is an error to call this function when multi-pass encoding has not been enabled by setting kVTCompressionPropertyKey_MultiPassStorage.

Parameter furtherPassesRequestedOut: Points to a Boolean that will be set to true if the video encoder would like to perform another pass, false otherwise. You may pass NULL to indicate that the client is certain to use this as the final pass, in which case the video encoder can skip that evaluation step.