Ссылка CMAttachment

Этот документ описывает Базовый присоединяемый протокол Носителей. A CMAttachmentBearer основанный на CF объект, поддерживающий комплект ключевого/значения/режима присоединения APIs. Можно присоединить любой объект CF к a CMAttachmentBearer объект хранить дополнительную информацию.

Функции

Разные функции


    
    CMCopyDictionaryOfAttachments (_: _: _:)
    CMCopyDictionaryOfAttachments

Возвраты все присоединения a CMAttachmentBearer.

Объявление

Swift

func CMCopyDictionaryOfAttachments(_ allocator: CFAllocator!, _ target: CMAttachmentBearer!, _ attachmentMode: CMAttachmentMode) -> Unmanaged<CFDictionary>!

Objective C

CFDictionaryRef CMCopyDictionaryOfAttachments ( CFAllocatorRef allocator, CMAttachmentBearerRef target, CMAttachmentMode attachmentMode );

Параметры

`allocator`	Средство выделения для нового словаря; передача `kCFAllocatorDefault` или `NULL` использовать средство выделения по умолчанию.
`target`	Указывает `CMAttachmentBearerRef` чьи присоединения Вы хотите получить.
`attachmentMode`	Режим присоединений Вы хотите получить. Посмотрите Присоединяемые Режимы для возможных значений.

Возвращаемое значение

Базовый словарь Основы со всеми присоединениями, идентифицированными их ключами. Если никакое присоединение не присутствует, словарь пуст. Возвраты NULL для недопустимого присоединяемого режима.

Обсуждение

CMCopyDictionaryOfAttachments вызов удобства, возвращающий все присоединения с их соответствующими ключами в новом CFDictionaryRef. Данный a CVBufferRef, CMCopyDictionaryOfAttachments подобно CVBufferGetAttachments, за исключением того, что CFDictionary возвращенный CMCopyDictionaryOfAttachments не обновляется для более поздних изменений в присоединениях.

Оператор импорта

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.


    
    CMGetAttachment (_: _: _:)
    CMGetAttachment

Возвращает определенное присоединение a CMAttachmentBearer.

Объявление

Swift

func CMGetAttachment(_ target: CMAttachmentBearer!, _ key: CFString!, _ attachmentModeOut: UnsafeMutablePointer<CMAttachmentMode>) -> Unmanaged<AnyObject>!

Objective C

CFTypeRef CMGetAttachment ( CMAttachmentBearerRef target, CFStringRef key, CMAttachmentMode *attachmentModeOut );

Параметры

`target`	Указывает `CMAttachmentBearer` чье присоединение Вы хотите получить.
`key`	Введите форму a `CFString` идентификация желаемого присоединения.
`attachmentModeOut`	На выводе, `attachmentMode` точки к режиму присоединения. Посмотрите Присоединяемые Режимы для возможных значений. Может быть `NULL`.

Возвращаемое значение

Если найдено, указанный присоединяемый объект; еще NULL.

Обсуждение

Можно присоединить любой Базовый объект Основы к a CMAttachmentBearer хранить дополнительную информацию. CMGetAttachment получает присоединение, идентифицированное ключом. Данный a CVBufferRef, CMGetAttachment эквивалентно CVBufferGetAttachment.

Оператор импорта

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.


    
    CMPropagateAttachments (_: _:)
    CMPropagateAttachments

Копии все присоединения, которые могут быть распространены от одного CMAttachmentBearer другому.

Объявление

Swift

func CMPropagateAttachments(_ source: CMAttachmentBearer!, _ destination: CMAttachmentBearer!)

Objective C

void CMPropagateAttachments ( CMAttachmentBearerRef source, CMAttachmentBearerRef destination );

Параметры

`source`	`CMAttachmentBearer` скопировать присоединения с.
`destination`	`CMAttachmentBearer` скопировать присоединения в.

Обсуждение

CMPropagateAttachments вызов удобства, копирующий все присоединения с режимом kCMAttachmentMode_ShouldPropagate от одного буфера до другого. Данный a CVBufferRef, CMPropagateAttachments эквивалентно CVBufferPropagateAttachments.

Оператор импорта

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.

CMRemoveAllAttachments (_:) CMRemoveAllAttachments

Удаляет все присоединения a CMAttachmentBearer.

Объявление

Swift

func CMRemoveAllAttachments(_ target: CMAttachmentBearer!)

Objective C

void CMRemoveAllAttachments ( CMAttachmentBearerRef target );

Параметры

target

CMAttachmentBearer чье присоединение Вы хотите удалить.

Обсуждение

В то время как CMRemoveAttachment удаляет определенное присоединение, идентифицированное ключом, CMRemoveAllAttachments удаляет все присоединения a CMAttachmentBearer и декременты их сохранять количества. Данный a CVBufferRef, CMRemoveAllAttachments эквивалентно CVBufferRemoveAllAttachments.

Оператор импорта

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.


    
    CMRemoveAttachment (_: _:)
    CMRemoveAttachment

Удаляет определенное присоединение a CMAttachmentBearer.

Объявление

Swift

func CMRemoveAttachment(_ target: CMAttachmentBearer!, _ key: CFString!)

Objective C

void CMRemoveAttachment ( CMAttachmentBearerRef target, CFStringRef key );

Параметры

`target`	`CMAttachmentBearer` содержа присоединение для удаления.
`key`	Введите форму Базовой строки Основы, идентифицирующей желаемое присоединение.

Обсуждение

CMRemoveAttachment удаляет присоединение, идентифицированное ключом. Если найдено, присоединение удалено, и сохранить количество постепенно уменьшается. Данный a CVBufferRef, CMRemoveAttachment эквивалентно CVBufferRemoveAttachment.

Оператор импорта

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.


    
    CMSetAttachment (_: _: _: _:)
    CMSetAttachment

Наборы или добавляют присоединение a CMAttachmentBearer.

Объявление

Swift

func CMSetAttachment(_ target: CMAttachmentBearer!, _ key: CFString!, _ value: AnyObject!, _ attachmentMode: CMAttachmentMode)

Objective C

void CMSetAttachment ( CMAttachmentBearerRef target, CFStringRef key, CFTypeRef value, CMAttachmentMode attachmentMode );

Параметры

`target`	A `CMAttachmentBearer` объект добавить или установить присоединения в.
`key`	Ключ, в форме Базовой строки Основы, идентифицируя желаемое присоединение.
`value`	Присоединение в форме Базового объекта Основы. Если этот параметр `NULL`, функция возвращает ошибку.
`attachmentMode`	Указывает присоединяемый режим для этого присоединения. Любой данный присоединяемый ключ может существовать только в одном режиме за один раз.

Обсуждение

Можно присоединить любой Базовый объект Основы к a CMAttachmentBearer объект хранить дополнительную информацию. CMSetAttachment хранит присоединение, идентифицированное ключом. Если ключ в настоящее время не существует для CMAttachmentBearer возразите, когда Вы вызываете эту функцию, новое присоединение добавляется. Если ключ действительно существует, существующее присоединение заменяется. В обоих случаях сохранить количество присоединения постепенно увеличивается. Значение может быть любым CFType но a NULL значение приведет к ошибке. Данный a CVBufferRef, CMSetAttachment эквивалентно CVBufferSetAttachment.

Оператор импорта

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.


    
    CMSetAttachments (_: _: _:)
    CMSetAttachments

Наборы ряд присоединений для a CMAttachmentBearer.

Объявление

Swift

func CMSetAttachments(_ target: CMAttachmentBearer!, _ theAttachments: CFDictionary!, _ attachmentMode: CMAttachmentMode)

Objective C

void CMSetAttachments ( CMAttachmentBearerRef target, CFDictionaryRef theAttachments, CMAttachmentMode attachmentMode );

Параметры

`target`	Цель `CMAttachmentBearer` установить attachement в.
`theAttachments`	Присоединения для установки, в форме Базового словаря Основы.
`attachmentMode`	Указывает присоединяемый режим для этого присоединения. Определенный присоединяемый ключ может только существовать в единственном режиме за один раз.

Обсуждение

CMSetAttachments поочередно вызывающий вызов удобства CMSetAttachment для каждого ключа и значения в данном словаре. Все пары значения ключа должны быть на корневом уровне словаря. Данный a CVBufferRef, CMSetAttachments эквивалентно CVBufferSetAttachments.

Оператор импорта

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.

Типы данных

Прочие условия

CMAttachmentBearerRef CMAttachmentBearerRef

Введите для объектов, которые могут перенести присоединения.

Объявление

Swift

typealias CMAttachmentBearerRef = CMAttachmentBearer

Objective C

typedef CFTypeRef CMAttachmentBearerRef;

Обсуждение

CMAttachmentBearer является Базовым Основанным на основе объектом, поддерживающим комплект ключевого/значения/режима присоединения APIs. Так как «плоскость» К не имеет никакого разделения на подклассы типа, CFType используется в качестве основания для типа CMAttachmentBearer. (Не все CFTypes поддерживают методы CMAttachmentBearer; если метод CMAttachmentBearer вызовут на объекте CF, не поддерживающем его, то он перестанет работать.)

Оператор импорта

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.
CMAttachmentMode CMAttachmentMode

Введите для указания присоединяемых режимов.

Объявление

Swift

typealias CMAttachmentMode = UInt32

Objective C

typedef uint32_t CMAttachmentMode;

Обсуждение

Для возможных значений посмотрите Присоединяемые Режимы.

Оператор импорта

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.

Константы

Присоединяемые режимы
Режимы распространения a CMAttachmentBearerRef присоединение.

Объявление

Swift

var kCMAttachmentMode_ShouldNotPropagate: Int { get } var kCMAttachmentMode_ShouldPropagate: Int { get }

Objective C

enum { kCMAttachmentMode_ShouldNotPropagate = 0, kCMAttachmentMode_ShouldPropagate = 1 };

Константы
- kCMAttachmentMode_ShouldNotPropagate
  
  kCMAttachmentMode_ShouldNotPropagate
  
  Не распространяйте это присоединение.
  
  Доступный в OS X v10.7 и позже.
- kCMAttachmentMode_ShouldPropagate
  
  kCMAttachmentMode_ShouldPropagate
  
  Скопируйте это присоединение при использовании CMPropagateAttachments функция.
  
  Доступный в OS X v10.7 и позже.
Обсуждение

Вы устанавливаете эти атрибуты при добавлении присоединений к a CMAttachmentBearerRef объект.