---
title: SetPreferredOutputChannelLayout
framework: audiodriverkit
role: symbol
role_heading: Instance Method
path: audiodriverkit/iouseraudiodevice/setpreferredoutputchannellayout
---

# SetPreferredOutputChannelLayout

Sets the output channel layout, using an array of audio channel label values.

## Declaration

```occ
kern_return_t SetPreferredOutputChannelLayout(IOUserAudioChannelLabel *in_channel_labels, size_t in_num_channels);
```

## Parameters

- `in_channel_labels`: An array of doc://com.apple.audiodriverkit/documentation/AudioDriverKit/AudioDriverKit/IOUserAudioChannelLabel values.
- `in_num_channels`: The number of items in the in_channel_labels array.

## Return Value

Return Value kIOReturnSuccess on success, or another value if an error occurs. For a list of error codes, see Error Codes.

## See Also

### Working with Channel Layouts

- [SetPreferredChannelsForStereo](audiodriverkit/iouseraudiodevice/setpreferredchannelsforstereo.md)
- [GetPreferredChannelsForStereo](audiodriverkit/iouseraudiodevice/getpreferredchannelsforstereo.md)
- [SetPreferredInputChannelLayout](audiodriverkit/iouseraudiodevice/setpreferredinputchannellayout.md)
- [IOUserAudioChannelLabel](audiodriverkit/audiodriverkit/iouseraudiochannellabel.md)