Function

CMSampleBufferCopyPCMDataIntoAudioBufferList(_:at:frameCount:into:)

Copies PCM audio data from the given sample buffer into a pre-populated AudioBufferList.

Declaration

func CMSampleBufferCopyPCMDataIntoAudioBufferList(_ sbuf: CMSampleBuffer, at frameOffset: Int32, frameCount numFrames: Int32, into bufferList: UnsafeMutablePointer<AudioBufferList>) -> OSStatus

Parameters

sbuf

The sample buffer containing the PCM audio data to be copied.

frameOffset

The frame offset number from which to begin the copy.

numFrames

The total number of frames to copy.

bufferList

The audio buffer list to populate.

Discussion

The AudioBufferList must contain the same number of channels and its data buffers must be sized to hold the specified number of frames.

This API is specific to audio format sample buffers, and will return kCMSampleBufferError_InvalidMediaTypeForOperation if called with a non-audio sample buffer. It will return an error if the sample buffer does not contain PCM audio data or if its data buffer is not ready.

See Also

Working with Audio Samples

func CMSampleBufferGetAudioStreamPacketDescriptionsPtr(CMSampleBuffer, packetDescriptionsPointerOut: UnsafeMutablePointer<UnsafePointer<AudioStreamPacketDescription>?>?, sizeOut: UnsafeMutablePointer<Int>?) -> OSStatus

Retrieves a pointer to a constant array of AudioStreamPacketDescriptions for the variable bytes per packet or variable frames per packet audio data in the provided CMSampleBuffer.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software