---
title: "CVBufferGetAttachment(_:_:_:)"
framework: corevideo
role: symbol
role_heading: Function
path: "corevideo/cvbuffergetattachment(_:_:_:)"
---

# CVBufferGetAttachment(_:_:_:)

Retrieves a specific attachment of a Core Video buffer.

## Declaration

```swift
func CVBufferGetAttachment(_ buffer: CVBuffer, _ key: CFString, _ attachmentMode: UnsafeMutablePointer<CVAttachmentMode>?) -> Unmanaged<CFTypeRef>?
```

## Parameters

- `buffer`: The buffer whose attachment you want to retrieve.
- `key`: A string that identifies the attachment, which can be of any doc://com.apple.documentation/documentation/CoreFoundation/CFTypeRef. See doc://com.apple.corevideo/documentation/CoreVideo/cvbuffer-attachment-keys and doc://com.apple.corevideo/documentation/CoreVideo/image-buffer-attachment-keys for predefined values.
- `attachmentMode`: On output, this value points to the mode of the attachment. See doc://com.apple.corevideo/documentation/CoreVideo/CVAttachmentMode for possible values. This value is doc://com.apple.documentation/documentation/ObjectiveC/nil-227m0 if the buffer doesn’t define an attachment mode.

## Return Value

Return Value The specified attachment, if it exists.

## See Also

### Working with attachments

- [CVBufferHasAttachment(_:_:)](corevideo/cvbufferhasattachment(_:_:).md)
- [CVBufferCopyAttachment(_:_:_:)](corevideo/cvbuffercopyattachment(_:_:_:).md)
- [CVBufferCopyAttachments(_:_:)](corevideo/cvbuffercopyattachments(_:_:).md)
- [CVBufferSetAttachment(_:_:_:_:)](corevideo/cvbuffersetattachment(_:_:_:_:).md)
- [CVBufferSetAttachments(_:_:_:)](corevideo/cvbuffersetattachments(_:_:_:).md)
- [CVBufferPropagateAttachments(_:_:)](corevideo/cvbufferpropagateattachments(_:_:).md)
- [CVBufferRemoveAttachment(_:_:)](corevideo/cvbufferremoveattachment(_:_:).md)
- [CVBufferRemoveAllAttachments(_:)](corevideo/cvbufferremoveallattachments(_:).md)
- [CVBufferGetAttachments(_:_:)](corevideo/cvbuffergetattachments(_:_:).md)