commit:count:

Enqueues an array of command buffers for execution.

Declaration

- (void) commit:(id<MTL4CommandBuffer> const[]) commandBuffers count:(NSUInteger) count;

Parameters

commandBuffers:
An array of Mtl4commandbuffer.
count:
The number of Mtl4commandbuffer instances in the commandBuffers array.

Mentioned in

Understanding the Metal 4 core API

Discussion

The order in which you sort the command buffers in the array is meaningful, especially when it contains suspending/resuming render passes. A suspending/resuming render pass is a render pass you create by calling makeRenderCommandEncoder(descriptor:options:), and provide MTL4RenderEncoderOptionSuspending or MTL4RenderEncoderOptionResuming for the options parameter.

If your command buffers contain suspend/resume render passes, ensure that the first command buffer only suspends, and the last one only resumes. Additionally, make sure that all intermediate command buffers are both suspending and resuming.