What is UnsafeMutablePointer <Unmanaged <CMSampleBuffer>?> In Swift?

Question

I need to call the CMSampleBufferCreateCopy function to create a copy of sampleBuffer, but I cannot figure out how to use it.

In accordance with this decision, it should work as follows:

var bufferCopy: Unmanaged<CMSampleBuffer>!

let error = CMSampleBufferCreateCopy(kCFAllocatorDefault, sampleBuffer, &bufferCopy)

But this is not so.

Error message:

Cannot invoke 'CMSampleBufferCreateCopy' with an argument list of type '(CFAllocator!, CMSampleBuffer!, inout Unmanaged<CMSampleBuffer>!)'

EDIT:

@availability(iOS, introduced=4.0)
func CMSampleBufferCreateCopy(allocator: CFAllocator!, sbuf: CMSampleBuffer!, sbufCopyOut: UnsafeMutablePointer<Unmanaged<CMSampleBuffer>?>) -> OSStatus

/*! @param allocator
                                                        The allocator to use for allocating the CMSampleBuffer object.
                                                        Pass kCFAllocatorDefault to use the default allocator. */
/*! @param sbuf
                                                        CMSampleBuffer being copied. */
/*! @param sbufCopyOut
                                                        Returned newly created CMSampleBuffer. */

/*!
    @function   CMSampleBufferCreateCopyWithNewTiming
    @abstract   Creates a CMSampleBuffer with new timing information from another sample buffer.
    @discussion This emulates CMSampleBufferCreateCopy, but changes the timing.
                Array parameters (sampleTimingArray) should have only one element if that same
                element applies to all samples. All parameters are copied; on return, the caller can release them,
                free them, reuse them or whatever.  Any outputPresentationTimestamp that has been set on the original Buffer
                will not be copied because it is no longer relevant.    On return, the caller owns the returned 
                CMSampleBuffer, and must release it when done with it.

 */

Answer 1

As you can see from the declaration of the last parameter,

sbufCopyOut: UnsafeMutablePointer<Unmanaged<CMSampleBuffer>?>

bufferCopy Must be declared as optional, and not as implicitly deployed optionally:

var bufferCopy: Unmanaged<CMSampleBuffer>?

Note that you must invoke takeRetainedValue()the result, so the complete solution will be:

var unmanagedBufferCopy: Unmanaged<CMSampleBuffer>?
if CMSampleBufferCreateCopy(kCFAllocatorDefault, sampleBuffer, &unmanagedBufferCopy) == noErr {
    let bufferCopy = unmanagedBufferCopy!.takeRetainedValue()
    // ...

} else {
    // failed
}

---

: Swift 4 (, , Swift 4) CMSampleBufferCreateCopy() ,

var bufferCopy: CMSampleBuffer?
if CMSampleBufferCreateCopy(kCFAllocatorDefault, sampleBuffer, &bufferCopy) == noErr {
    // ... use bufferCopy! ...
} else {
    // failed
}