<!--
{
  "availability" : [
    "iOS: 2.1.0 -",
    "iPadOS: 2.1.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.4.0 -",
    "tvOS: 9.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AudioToolbox",
  "identifier" : "/documentation/AudioToolbox/ExtAudioFileWrapAudioFileID(_:_:_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "Audio Toolbox"
    ],
    "preciseIdentifier" : "c:@F@ExtAudioFileWrapAudioFileID"
  },
  "title" : "ExtAudioFileWrapAudioFileID(_:_:_:)"
}
-->

# ExtAudioFileWrapAudioFileID(_:_:_:)

Wraps an audio file object in an extended audio file object.

```
func ExtAudioFileWrapAudioFileID(_ inFileID: AudioFileID, _ inForWriting: Bool, _ outExtAudioFile: UnsafeMutablePointer<ExtAudioFileRef?>) -> OSStatus
```

## Parameters

`inFileID`

The audio file object to wrap.

`inForWriting`

Use `true` if you intend to write to the audio file, `false` otherwise.

`outExtAudioFile`

On output, a newly allocated extended audio file object.

## Return Value

A result code.

## Discussion

Allocates a new extended audio file object that wraps an existing audio file object. Your application is responsible for keeping the audio file object open until the extended audio file object is disposed.

---

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)