<!--
{
  "availability" : [
    "iOS: 14.0.0 -",
    "iPadOS: 14.0.0 -",
    "macCatalyst: 14.0.0 -",
    "macOS: 11.0.0 -",
    "tvOS: 14.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Metal",
  "identifier" : "/documentation/Metal/MTLCommandBufferEncoderInfo",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "Metal"
    ],
    "preciseIdentifier" : "c:objc(pl)MTLCommandBufferEncoderInfo"
  },
  "title" : "MTLCommandBufferEncoderInfo"
}
-->

# MTLCommandBufferEncoderInfo

A container that provides additional information about a runtime failure a GPU encounters as it runs the commands in a command buffer.

```
protocol MTLCommandBufferEncoderInfo : NSObjectProtocol
```

## Overview

To create a command buffer that generates additional information (when a GPU encounters an error running it), configure an [`MTLCommandBufferDescriptor`](/documentation/Metal/MTLCommandBufferDescriptor) instance’s [`errorOptions`](/documentation/Metal/MTLCommandBufferDescriptor/errorOptions) property. For information about how to retrieve the information from an [`MTLCommandBuffer`](/documentation/Metal/MTLCommandBuffer) instance, see its [`error`](/documentation/Metal/MTLCommandBuffer/error) property.

## Topics

### Inspecting execution information

[`label`](/documentation/Metal/MTLCommandBufferEncoderInfo/label)

The name of the encoder that generates the error information.

[`debugSignposts`](/documentation/Metal/MTLCommandBufferEncoderInfo/debugSignposts)

An array of debug signposts that Metal records as the GPU executes the commands of the encoder’s pass.

[`errorState`](/documentation/Metal/MTLCommandBufferEncoderInfo/errorState)

The execution status of the command encoder.

[`MTLCommandEncoderErrorState`](/documentation/Metal/MTLCommandEncoderErrorState)

Possible error conditions for the command encoder’s commands.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)