---
title: MTLPipelineBufferDescriptor
framework: metal
role: symbol
role_heading: Class
path: metal/mtlpipelinebufferdescriptor
---

# MTLPipelineBufferDescriptor

The mutability options for a buffer that a render or compute pipeline uses.

## Declaration

```swift
class MTLPipelineBufferDescriptor
```

## Overview

Overview Metal can perform additional optimizations if you guarantee that neither the CPU nor the GPU modify a buffer’s contents before starting a pass. Use immutable buffers as much as possible to take advantage of Metal optimizations. To declare that a buffer is immutable, set the mutability property of their associated MTLPipelineBufferDescriptor object to MTLMutability.immutable.

## Topics

### Setting buffer mutability

- [mutability](metal/mtlpipelinebufferdescriptor/mutability.md)
- [MTLMutability](metal/mtlmutability.md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCopying](foundation/nscopying.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)

## See Also

### Configuring a compute pipeline state

- [MTL4ComputePipelineDescriptor](metal/mtl4computepipelinedescriptor.md)
- [MTLComputePipelineDescriptor](metal/mtlcomputepipelinedescriptor.md)
- [MTLComputePipelineState](metal/mtlcomputepipelinestate.md)
- [MTLStageInputOutputDescriptor](metal/mtlstageinputoutputdescriptor.md)
- [MTLPipelineBufferDescriptorArray](metal/mtlpipelinebufferdescriptorarray.md)
- [MTLPipelineOption](metal/mtlpipelineoption.md)