Enumeration

MTLCommandBufferError.Code

Error codes that indicate why the execution of the command buffer has failed. The error property contains the error code.

Declaration

enum MTLCommandBufferError.Code : UInt, _ErrorCodeProtocol

Topics

Constants

case none

No error occurred.

case `internal`

An internal error that doesn't fit into the other categories.

case timeout

Execution of this command buffer took more time than the system allows, so execution was interrupted and aborted.

case pageFault

Execution of this command buffer generated an unserviceable GPU page fault.

case blacklisted

Access to this device has been revoked because this client has been responsible for too many timeouts or hangs.

case notPermitted

This process does not have access to use this device.

case outOfMemory

Insufficient memory was available to execute this command buffer.

case invalidResource

The command buffer referenced an invalid resource.

case memoryless

One or more internal resource limits was reached that prevent using memoryless render pass attachments.

case deviceRemoved

The device was physically removed before the command could finish execution.

See Also

Obtaining Status and Timestamps

var status: MTLCommandBufferStatus

The current stage in the lifetime of the command buffer.

Required.

enum MTLCommandBufferStatus

The stages in the lifetime of the command buffer.

var error: Error?

The error that occurred when the command buffer was executed.

Required.

struct MTLCommandBufferError

Error codes that indicate why the execution of the command buffer has failed.

let MTLCommandBufferErrorDomain: String

The error domain used by MTLCommandBuffer when returning command buffer execution errors.

var kernelStartTime: CFTimeInterval

The host time, in seconds, when the CPU began scheduling this command buffer for execution.

Required.

var kernelEndTime: CFTimeInterval

The host time, in seconds, when the CPU finished scheduling this command buffer for execution.

Required.

var gpuStartTime: CFTimeInterval

The host time, in seconds, when the GPU began executing this command buffer.

Required.

var gpuEndTime: CFTimeInterval

The host time, in seconds, when the GPU finished executing this command buffer.

Required.