# CMGetAttachment(_:key:attachmentModeOut:) Returns an attachment from an attachment bearer object. ``` func CMGetAttachment(_ target: CMAttachmentBearer, key: CFString, attachmentModeOut: UnsafeMutablePointer?) -> CFTypeRef? ``` ## Parameters `target` Specifies the `CMAttachmentBearer` whose attachment you want to retrieve. `key` Key in the form of a `CFString` identifying the desired attachment. `attachmentModeOut` On output, `attachmentMode` points to the mode of the attachment. See [`CMAttachmentMode`](/documentation/CoreMedia/CMAttachmentMode)for possible values. May be `NULL`. ## Return Value The requested attachment object or `NULL` if not found. ## Discussion You can attach any Core Foundation object to a `CMAttachmentBearer` to store additional information. `CMGetAttachment` retrieves an attachment identified by a key. Given a , `CMGetAttachment` is equivalent to . --- Copyright © 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)