Function VTDecompressionSessionDecodeFrame

Source
pub unsafe extern "C-unwind" fn VTDecompressionSessionDecodeFrame(
    session: &VTDecompressionSession,
    sample_buffer: &CMSampleBuffer,
    decode_flags: VTDecodeFrameFlags,
    source_frame_ref_con: *mut c_void,
    info_flags_out: *mut VTDecodeInfoFlags,
) -> i32
Available on crate features VTErrors and objc2-core-media and VTDecompressionSession only.
Expand description

Decompresses a video frame.

If an error is returned from this function, there will be no callback. Otherwise the callback provided during VTDecompressionSessionCreate will be called.

Parameter session: The decompression session.

Parameter sampleBuffer: A CMSampleBuffer containing one or more video frames.

Parameter decodeFlags: A bitfield of directives to the decompression session and decoder. The kVTDecodeFrame_EnableAsynchronousDecompression bit indicates whether the video decoder may decompress the frame asynchronously. The kVTDecodeFrame_EnableTemporalProcessing bit indicates whether the decoder may delay calls to the output callback so as to enable processing in temporal (display) order. If both flags are clear, the decompression shall complete and your output callback function will be called before VTDecompressionSessionDecodeFrame returns. If either flag is set, VTDecompressionSessionDecodeFrame may return before the output callback function is called.

Parameter sourceFrameRefCon: Your reference value for the frame. Note that if sampleBuffer contains multiple frames, the output callback function will be called multiple times with this sourceFrameRefCon.

Parameter infoFlagsOut: Points to a VTDecodeInfoFlags to receive information about the decode operation. The kVTDecodeInfo_Asynchronous bit may be set if the decode is (or was) running asynchronously. The kVTDecodeInfo_FrameDropped bit may be set if the frame was dropped (synchronously). Pass NULL if you do not want to receive this information.