---
title: "makeRenderPipelineState(descriptor:options:reflection:)"
framework: metal
role: symbol
role_heading: Instance Method
path: "metal/mtldevice/makerenderpipelinestate(descriptor:options:reflection:)"
---

# makeRenderPipelineState(descriptor:options:reflection:)

Synchronously creates a render pipeline state and reflection information.

## Declaration

```swift
func makeRenderPipelineState(descriptor: MTLRenderPipelineDescriptor, options: MTLPipelineOption, reflection: AutoreleasingUnsafeMutablePointer<MTLAutoreleasedRenderPipelineReflection?>?) throws -> any MTLRenderPipelineState
```

## Parameters

- `descriptor`: An doc://com.apple.metal/documentation/Metal/MTLRenderPipelineDescriptor instance.
- `options`: An doc://com.apple.metal/documentation/Metal/MTLPipelineOption instance that represents the reflection information you want the method to generate.
- `reflection`: In Swift, an optional pointer to an doc://com.apple.metal/documentation/Metal/MTLAutoreleasedRenderPipelineReflection optional. In Objective-C, a pointer to an doc://com.apple.metal/documentation/Metal/MTLAutoreleasedRenderPipelineReflection instance. Pass nil in either language when you don’t need reflection data. Otherwise on return, if the method completes successfully, it assigns an doc://com.apple.metal/documentation/Metal/MTLRenderPipelineReflection instance to the pointee, which contains the details about the function arguments.

## Return Value

Return Value A new MTLRenderPipelineState instance if the method completes successfully; otherwise Swift throws an error and Objective-C returns nil.

## Discussion

Discussion Use the graphics-rendering pipeline state to configure a render pass by calling the setRenderPipelineState(_:) method of an MTLRenderCommandEncoder instance.

## See Also

### Creating render pipeline states with vertex shaders

- [makeRenderPipelineState(descriptor:)](metal/mtldevice/makerenderpipelinestate(descriptor:).md)
- [makeRenderPipelineState(descriptor:completionHandler:)](metal/mtldevice/makerenderpipelinestate(descriptor:completionhandler:).md)
- [makeRenderPipelineState(descriptor:options:)](metal/mtldevice/makerenderpipelinestate(descriptor:options:)-89vxc.md)
- [makeRenderPipelineState(descriptor:options:completionHandler:)](metal/mtldevice/makerenderpipelinestate(descriptor:options:completionhandler:)-5gdww.md)