Ссылка CMSampleBuffer

Этот документ описывает API, который Вы используете, чтобы создать и управлять CMSampleBuffer непрозрачный тип.

CMSampleBuffers Базовые объекты Основы, содержащие нуль или более сжатый (или несжатый) выборки определенного типа среды (аудио, видео, мультиплексированное, и т.д.), которые используются для перемещения демонстрационных данных носителей через систему носителей. A CMSampleBuffer может содержать:

A CMBlockBuffer из одной или более выборок носителей, или
A CVImageBuffer, ссылка на описание формата для потока CMSampleBuffers, размер и информация синхронизации для каждой из содержавших выборок носителей, и и присоединения буферного уровня и демонстрационного уровня.

Демонстрационный буфер может содержать и присоединения демонстрационного уровня и буферного уровня. Присоединения демонстрационного уровня связаны с каждой отдельной выборкой (кадр) в буфере и включают информацию, такую как зависимости от видеокадра и метки времени. Можно считать и записать присоединения демонстрационного уровня с помощью CMSampleBufferGetSampleAttachmentsArray функция. Присоединения буферного уровня предоставляют информацию о буфере в целом, таком как скорость воспроизведения и действия, которые будут выполняться после потребления буфера. Можно читать и присоединения уровня буфера записи с помощью APIs, описанного в Ссылке CMAttachment и ключах, перечисленных под Демонстрационными Буферными Присоединяемыми Ключами.

Это возможно для a CMSampleBuffer для описания выборок, это еще не содержит. Например, некоторые мультимедийные службы могут иметь доступ к объему выборки, информации синхронизации и данным о формате, прежде чем будут считаны данные. Такие службы могут создать CMSampleBuffers с той информацией и вставляют их в очереди рано и присоединение (или заливка) CMBlockBuffers из данных носителей позже, когда данные становятся готовыми. С этой целью, CMSampleBuffers имейте понятие готовности данных, которая может быть протестирована, установите, вынужденный стать готовыми “теперь" и т.д. Это также возможно для a CMSampleBuffer содержать только специальное присоединение буферного уровня, описывающее событие мультимедийного потока (например, «разрыв: истощите и сбросьте декодер прежде, чем обработать следующее CMSampleBuffer”). Такое специальное присоединение может также быть присоединено регулярный CMSampleBuffers (т.е. которые содержат демонстрационные данные носителей), и если так, событие, которое они описывают, определяется для появления после выборок в этом CMSampleBuffer.

Функции

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


    
    CMAudioSampleBufferCreateWithPacketDescriptions (_: _: _: _: _: _: _: _: _: _:)
    CMAudioSampleBufferCreateWithPacketDescriptions

Создает a CMSampleBuffer содержа аудио для данного packetDescription вместо калибровки и информации синхронизации.

Объявление

Swift

func CMAudioSampleBufferCreateWithPacketDescriptions(_ allocator: CFAllocator!, _ dataBuffer: CMBlockBuffer!, _ dataReady: Boolean, _ makeDataReadyCallback: CMSampleBufferMakeDataReadyCallback, _ makeDataReadyRefcon: UnsafeMutablePointer<Void>, _ formatDescription: CMFormatDescription!, _ numSamples: CMItemCount, _ sbufPTS: CMTime, _ packetDescriptions: UnsafePointer<AudioStreamPacketDescription>, _ sBufOut: UnsafeMutablePointer<Unmanaged<CMSampleBuffer>?>) -> OSStatus

Objective C

OSStatus CMAudioSampleBufferCreateWithPacketDescriptions ( CFAllocatorRef allocator, CMBlockBufferRef dataBuffer, Boolean dataReady, CMSampleBufferMakeDataReadyCallback makeDataReadyCallback, void *makeDataReadyRefcon, CMFormatDescriptionRef formatDescription, CMItemCount numSamples, CMTime sbufPTS, const AudioStreamPacketDescription *packetDescriptions, CMSampleBufferRef *sBufOut );

Параметры

`allocator`	Средство выделения для использования для выделения `CMSampleBuffer` объект. Передача `kCFAllocatorDefault` использовать средство выделения по умолчанию.
`dataBuffer`	`CMBlockBuffer` для данных носителей. Это может быть `NULL`, a `CMBlockBuffer` без резервной памяти, a `CMBlockBuffer` с резервной памятью, но никакими данными все же или a `CMBlockBuffer` это уже содержит данные носителей. Если `CMBlockBuffer` содержит данные носителей, `dataReady` должен быть `true`.
`dataReady`	Указывает действительно ли `BlockBuffer` уже содержит данные носителей.
`makeDataReadyCallback`	Обратный вызов это `CMSampleBufferMakeDataReady` должен вызвать для создания данных готовыми. Может быть `NULL`.
`makeDataReadyRefcon`	Ссылочная константа,`CMSampleBufferMakeDataReady`, то, что эта функция должна передать обратному вызову.
`formatDescription`	Описание формата данных носителей. Не может быть `NULL`.
`numSamples`	Число выборок в `CMSampleBuffer`. Не должен быть 0.
`sbufPTS`	Метка времени первой выборки в буфере. Должно быть числовое `CMTime`.
`packetDescriptions`	Массив `packetDescriptions`, один для каждого из `numSamples`. Может быть `NULL` если выборки, как известно, имеют постоянное число кадров на пакет и постоянный размер.
`sBufOut`	На выводе, точках к недавно создаваемому `CMSampleBuffer`.

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

Код результата. Посмотрите Коды Результата.

Обсуждение

Обеспечивает оптимизацию CMSampleBufferCreate(), когда вызывающая сторона уже имеет packetDescriptions для аудиоданных. Эта подпрограмма будет использовать packetDescriptions для создания калибровки и синхронизации массивов, требуемых сделать демонстрационный буфер при необходимости.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferCallForEachSample (_: _: _:)
    CMSampleBufferCallForEachSample

Вызывает функцию для каждой отдельной выборки в демонстрационном буфере.

Объявление

Swift

func CMSampleBufferCallForEachSample(_ sbuf: CMSampleBuffer!, _ refcon: CFunctionPointer<((CMSampleBuffer!, CMItemCount, UnsafeMutablePointer<Void>) -> OSStatus)>, _ refcon: UnsafeMutablePointer<Void>) -> OSStatus

Objective C

OSStatus CMSampleBufferCallForEachSample ( CMSampleBufferRef sbuf, OSStatus (*callback)( CMSampleBufferRef sampleBuffer, CMItemCount index, void *refcon), void *refcon );

Параметры

`sbuf`	`CMSampleBuffer` это может содержать многократные выборки.
`refcon`	Функция, которую вызовут для каждой отдельной выборки.
`refcon`	Refcon, который будет передан функции обратного вызова.

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

Код результата. Посмотрите Коды Результата.

Обсуждение

Система создаст временные демонстрационные буферы для отдельных выборок. Каждый демонстрационный буфер будет относиться к демонстрационным данным и содержащий его синхронизацию, размер и присоединения. Функция обратного вызова может сохранить эти демонстрационные буферы при желании. Если функция обратного вызова возвратит ошибку, то итерация сразу остановится и функционировать возвраты ошибка, полученная от обратного вызова. Функция возвратится kCMSampleBufferError_CannotSubdivide ошибка, при отсутствии объемов выборки в предоставленном демонстрационном буфере. Это произойдет, например, если выборки в буфере будут состоящими из нескольких несмежных участков (например, нечередующееся аудио, где значения канала для единственной выборки рассеиваются через буфер).

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferCopySampleBufferForRange (_: _: _: _:)
    CMSampleBufferCopySampleBufferForRange

Создает a CMSampleBuffer содержа диапазон выборок от существующего CMSampleBuffer.

Объявление

Swift

func CMSampleBufferCopySampleBufferForRange(_ allocator: CFAllocator!, _ sbuf: CMSampleBuffer!, _ sampleRange: CFRange, _ sBufOut: UnsafeMutablePointer<Unmanaged<CMSampleBuffer>?>) -> OSStatus

Objective C

OSStatus CMSampleBufferCopySampleBufferForRange ( CFAllocatorRef allocator, CMSampleBufferRef sbuf, CFRange sampleRange, CMSampleBufferRef *sBufOut );

Параметры

`allocator`	Средство выделения для использования для выделения `CMSampleBuffer` объект. Передача `kCFAllocatorDefault` использовать средство выделения по умолчанию.
`sbuf`	`CMSampleBuffer` содержа исходные выборки.
`sampleRange`	Диапазон выборок для копирования с `sbuf`, где демонстрационный 0 является первой выборкой в `sbuf`
`sBufOut`	На выводе, точках к недавно создаваемому `CMSampleBuffer`.

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

Код результата. Посмотрите Коды Результата

Обсуждение

Выборки, содержащие нечередующееся аудио, в настоящее время не поддерживаются.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferCreate (_: _: _: _: _: _: _: _: _: _: _: _:)
    CMSampleBufferCreate

Создает CMSampleBuffer.

Объявление

Swift

func CMSampleBufferCreate(_ allocator: CFAllocator!, _ dataBuffer: CMBlockBuffer!, _ dataReady: Boolean, _ makeDataReadyCallback: CMSampleBufferMakeDataReadyCallback, _ makeDataReadyRefcon: UnsafeMutablePointer<Void>, _ formatDescription: CMFormatDescription!, _ numSamples: CMItemCount, _ numSampleTimingEntries: CMItemCount, _ sampleTimingArray: UnsafePointer<CMSampleTimingInfo>, _ numSampleSizeEntries: CMItemCount, _ sampleSizeArray: UnsafePointer<UInt>, _ sBufOut: UnsafeMutablePointer<Unmanaged<CMSampleBuffer>?>) -> OSStatus

Objective C

OSStatus CMSampleBufferCreate ( CFAllocatorRef allocator, CMBlockBufferRef dataBuffer, Boolean dataReady, CMSampleBufferMakeDataReadyCallback makeDataReadyCallback, void *makeDataReadyRefcon, CMFormatDescriptionRef formatDescription, CMItemCount numSamples, CMItemCount numSampleTimingEntries, const CMSampleTimingInfo *sampleTimingArray, CMItemCount numSampleSizeEntries, const size_t *sampleSizeArray, CMSampleBufferRef *sBufOut );

Параметры

`allocator`	Средство выделения для использования для выделения `CMSampleBuffer` объект. Передача `kCFAllocatorDefault` использовать средство выделения по умолчанию.
`dataBuffer`	`CMBlockBuffer` для данных носителей. Это может быть `NULL`, a `CMBlockBuffer` без резервной памяти, a `CMBlockBuffer` с резервной памятью, но никакими данными все же или a `CMBlockBuffer` это уже содержит данные носителей. Если `CMBlockBuffer` содержит данные носителей, `dataReady` должен быть `true`. Булевская переменная `dataReady` должен также быть `true` если `dataBuffer` `Null` и `numSamples` 0.
`dataReady`	Указывает, содержит ли BlockBuffer уже данные носителей
`makeDataReadyCallback`	Обратный вызов это `CMSampleBufferMakeDataReady` должен вызвать для создания данных готовыми. Может быть `NULL`.
`makeDataReadyRefcon`	Refcon `CMSampleBufferMakeDataReady` должен передать обратному вызову.
`formatDescription`	Описание формата данных носителей. Может быть `NULL`.
`numSamples`	Число выборок в `CMSampleBuffer`. Может быть нуль.
`numSampleTimingEntries`	Число записей в `sampleTimingArray`. Должен быть 0, 1, или `numSamples`.
`sampleTimingArray`	Массив `CMSampleTimingInfo` структуры, одна структура на выборку. Если все выборки имеют ту же продолжительность и находятся в порядке представления, можно передать сингл `CMSampleTimingInfo` структура с набором продолжительности к продолжительности одной выборки, `presentationTimeStamp` набор ко времени представления численно самой ранней выборки, и `decodeTimeStamp` набор к `kCMTimeInvalid`. Поведение не определено если выборки в a `CMSampleBuffer` (или даже в многократных буферах в том же потоке), имеют то же `presentationTimeStamp`. Может быть `NULL`.
`numSampleSizeEntries`	Число записей в `sampleSizeArray`. Должен быть 0, 1, или numSamples.
`sampleSizeArray`	Массив записей размера, одной записи на выборку. Если все выборки имеют тот же размер, можно передать единственную запись размера, содержащую размер одной выборки. Может быть `NULL`. Должен быть NULL, если выборки являются состоящими из нескольких несмежных участков в буфере (например, нечередующееся аудио, где значения канала для единственной выборки рассеиваются через буфер).
`sBufOut`	На выводе, точках к недавно создаваемому `CMSampleBuffer`.

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

Код результата. Посмотрите Коды Результата.

Обсуждение

Если тот же самый элемент применяется ко всем выборкам, параметры массива (sampleSizeArray, sampleTimingArray) должны иметь только один элемент. Все параметры копируются. По возврату вызывающая сторона может выпустить их, освободить их или снова использовать их. По возврату вызывающей стороне принадлежит возвращенный CMSampleBuffer, и должен выпустить его, когда сделано с ним.

Пример использования для видеокадров «в порядке дисплея»:

буфер данных: содержит 7 Движений кадры JPEG
dataFormatDescription: описывает Движение видео JPEG
dataFormatDescription: описывает Движение видео JPEG
numSamples: 7
numSampleTimingEntries: 1
sampleTimingArray: одна запись = {продолжительность = 1001/30000, presentationTimeStamp = 0/30000, decodeTimeStamp = недопустимый}
numSampleSizeEntries: 7
sampleSizeArray: {105840, 104456, 103464, 116460, 100412, 94808, 120400}

Пример использования для видеокадров в порядка дисплея:

буфер данных: содержит 6 кадров H.264 в порядке декодирования (P2, B0, B1, I5, B3, B4)
dataFormatDescription: описывает видео H.264
numSamples: 6
numSampleTimingEntries: 6
sampleTimingArray: 6 записей = {
- {продолжительность = 1001/30000, presentationTimeStamp = 12012/30000, decodeTimeStamp = 10010/30000},
- {продолжительность = 1001/30000, presentationTimeStamp = 10010/30000, decodeTimeStamp = 11011/30000},
- {продолжительность = 1001/30000, presentationTimeStamp = 11011/30000, decodeTimeStamp = 12012/30000},
- {продолжительность = 1001/30000, presentationTimeStamp = 15015/30000, decodeTimeStamp = 13013/30000},
- {продолжительность = 1001/30000, presentationTimeStamp = 13013/30000, decodeTimeStamp = 14014/30000},
- {продолжительность = 1001/30000, presentationTimeStamp = 13013/30000, decodeTimeStamp = 14014/30000}}
numSampleSizeEntries: 6
sampleSizeArray: {10580, 1234, 1364, 75660, 1012, 988}

Пример использования для сжатого аудио:

буфер данных: содержит 24, сжал пакеты AAC
dataFormatDescription: описывает аудио AAC на 44.1 кГц
numSamples: 24
numSampleTimingEntries: 1
sampleTimingArray: одна запись = {{продолжительность = 1024/44100, presentationTimeStamp = 0/44100, decodeTimeStamp = недопустимый}}
numSampleSizeEntries: 24
sampleSizeArray: {191, 183, 208, 213, 202, 206, 209, 206, 204, 192, 202, 277, <литий> 282, 240, 209, 194, 193, 197, 196, 198, 168, 199, 171, 194}

Пример использования для несжатого чередованного аудио:

буфер данных: содержит 24 000 несжатых чередованных кадров стерео, каждый содержащий 2 Float32s =
- {{L, R},
- {L, R},
- {L, R}...}
dataFormatDescription: описывает чередованное аудио Float32 на 48 кГц
numSamples: 24000
numSampleTimingEntries: 1
sampleTimingArray: одна запись = {{продолжительность = 1/48000, presentationTimeStamp = 0/48000, decodeTimeStamp = недопустимый}}
numSampleSizeEntries: 1
sampleSizeArray: {8}

Пример использования для несжатого нечередующегося аудио:

буфер данных: содержит 24 000 несжатых нечередующихся кадров стерео, каждый содержащий 2 Float32s (состоящих из нескольких несмежных участков) =
- {{L, L, L, L, L...},
- {R, R, R, R, R...}}
dataFormatDescription: описывает Float32 на 48 кГц нечередующееся аудио
numSamples: 24000
numSampleTimingEntries: 1
sampleTimingArray: одна запись = {продолжительность = 1/48000, presentationTimeStamp = 0/48000, decodeTimeStamp = недопустимый}
numSampleSizeEntries: 0
sampleSizeArray: NULL (потому что выборки не непрерывны),

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferCreateCopy (_: _: _:)
    CMSampleBufferCreateCopy

Создает копию a CMSampleBuffer

Объявление

Swift

func CMSampleBufferCreateCopy(_ allocator: CFAllocator!, _ sbuf: CMSampleBuffer!, _ sbufCopyOut: UnsafeMutablePointer<Unmanaged<CMSampleBuffer>?>) -> OSStatus

Objective C

OSStatus CMSampleBufferCreateCopy ( CFAllocatorRef allocator, CMSampleBufferRef sbuf, CMSampleBufferRef *sbufCopyOut );

Параметры

`allocator`	Средство выделения для использования для выделения `CMSampleBuffer` объект. Передача `kCFAllocatorDefault` использовать средство выделения по умолчанию.
`sbuf`	`CMSampleBuffer` быть скопированным.
`sbufCopyOut`	На выводе, точках к недавно создаваемой копии `CMSampleBuffer`.

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

Код результата. Посмотрите Коды Результата

Обсуждение

Копия мелка: скалярные свойства (размеры и синхронизирующий) копируются непосредственно, буфер данных и форматируют описание, сохраняются, и присоединения, которые могут быть распространены, сохраняются словарем копии. Если sbuf's данные не готовы, копия будет установлена отследить свою готовность.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferCreateCopyWithNewTiming (_: _: _: _: _:)
    CMSampleBufferCreateCopyWithNewTiming

Создает копию CMSampleBuffer с новой информацией синхронизации.

Объявление

Swift

func CMSampleBufferCreateCopyWithNewTiming(_ allocator: CFAllocator!, _ originalSBuf: CMSampleBuffer!, _ numSampleTimingEntries: CMItemCount, _ sampleTimingArray: UnsafePointer<CMSampleTimingInfo>, _ sBufCopyOut: UnsafeMutablePointer<Unmanaged<CMSampleBuffer>?>) -> OSStatus

Objective C

OSStatus CMSampleBufferCreateCopyWithNewTiming ( CFAllocatorRef allocator, CMSampleBufferRef originalSBuf, CMItemCount numSampleTimingEntries, const CMSampleTimingInfo *sampleTimingArray, CMSampleBufferRef *sBufCopyOut );

Параметры

`allocator`	Средство выделения для использования для выделения `CMSampleBuffer` объект. Передача `kCFAllocatorDefault` использовать средство выделения по умолчанию.
`originalSBuf`	`CMSampleBuffer` содержа исходные выборки.
`numSampleTimingEntries`	Число записей в `sampleTimingArray`. Должен быть 0, 1, или numSamples в исходном sampleBuffer.
`sampleTimingArray`	Массив `CMSampleTimingInfo` структуры, одна структура на выборку. Если все выборки имеют ту же продолжительность и находятся в порядке представления, можно передать сингл `CMSampleTimingInfo` структура с набором продолжительности к продолжительности одной выборки, `presentationTimeStamp` набор ко времени представления численно самой ранней выборки, и `decodeTimeStamp` набор к `kCMTimeInvalid`. Поведение не определено если выборки в a `CMSampleBuffer` (или даже в многократных буферах в том же потоке), имеют тот же presentationTimeStamp. Может быть `NULL`.
`sBufCopyOut`	На выводе, точках к недавно создаваемой копии `CMSampleBuffer`.

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

Код результата. Посмотрите Коды Результата

Обсуждение

Это эмулирует CMSampleBufferCreateCopy, но изменяет синхронизацию. Если тот же самый элемент применяется ко всем выборкам, параметры массива (sampleTimingArray) должны иметь только один элемент. Все параметры копируются; по возврату вызывающая сторона может выпустить их, освободить их или снова использовать их. Любой outputPresentationTimestamp это было установлено на исходном Буфере, не будет скопирован, потому что это больше не релевантно. По возврату вызывающей стороне принадлежит возвращенный CMSampleBuffer, и должен выпустить его, когда сделано с ним.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferCreateForImageBuffer (_: _: _: _: _: _: _: _:)
    CMSampleBufferCreateForImageBuffer

Создает a CMSampleBuffer это содержит a CVImageBuffer вместо a CMBlockBuffer.

Объявление

Swift

func CMSampleBufferCreateForImageBuffer(_ allocator: CFAllocator!, _ imageBuffer: CVImageBuffer!, _ dataReady: Boolean, _ makeDataReadyCallback: CMSampleBufferMakeDataReadyCallback, _ makeDataReadyRefcon: UnsafeMutablePointer<Void>, _ formatDescription: CMVideoFormatDescription!, _ sampleTiming: UnsafePointer<CMSampleTimingInfo>, _ sBufOut: UnsafeMutablePointer<Unmanaged<CMSampleBuffer>?>) -> OSStatus

Objective C

OSStatus CMSampleBufferCreateForImageBuffer ( CFAllocatorRef allocator, CVImageBufferRef imageBuffer, Boolean dataReady, CMSampleBufferMakeDataReadyCallback makeDataReadyCallback, void *makeDataReadyRefcon, CMVideoFormatDescriptionRef formatDescription, const CMSampleTimingInfo *sampleTiming, CMSampleBufferRef *sBufOut );

Параметры

`allocator`	Средство выделения для использования для выделения `CMSampleBuffer` объект. Передача `kCFAllocatorDefault` использовать средство выделения по умолчанию.
`imageBuffer`	`CVImageBuffer` для данных носителей. Это может быть a `CVImageBuffer` чье содержание еще не было представлено, или a `CVImageBuffer` это уже содержит данные носителей (когда `dataReady` должна быть истина). Может не быть `NULL`.
`dataReady`	Указывает действительно ли `CVImageBuffer` уже содержит данные носителей.
`makeDataReadyCallback`	Обратный вызов это `CMSampleBufferMakeDataReady` должен вызвать для создания данных готовыми. Может быть `NULL`.
`makeDataReadyRefcon`	Refcon `CMSampleBufferMakeDataReady` должен передать обратному вызову.
`formatDescription`	Описание формата данных носителей. Посмотрите обсуждение выше для ограничений. Может не быть `NULL`.
`sampleTiming`	A `CMSampleTimingInfo` структура, обеспечивающая информацию синхронизации для носителей, представленных `CVImageBuffer`.
`sBufOut`	На выводе, точках к недавно создаваемому `CMSampleBuffer` это содержит a `CVImageBuffer`.

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

Код результата. Посмотрите Демонстрационные Буферные Коды Результата

Обсуждение

В отличие от a CMBlockBuffer который может сослаться на многие выборки, a CVImageBuffer определяется для ссылки только на одну выборку; поэтому эта подпрограмма имеет меньше параметров, чем CMSampleBufferCreate. Демонстрационная информация синхронизации, которая является вектором для CMSampleBufferCreate, состоит только из одного значения для этой подпрограммы. Понятие объема выборки не применяется к CVImageBuffers. Также, CMSampleBufferGetSampleSizeArray возвратится kCMSampleBufferError_BufferHasNoSampleSizes, и CMSampleBufferGetSampleSize возвратится 0. Поскольку CVImageBuffers содержите визуальные данные, предоставленное описание формата является a CMVideoFormatDescription. Описание формата должно быть соответствующим атрибутам и информации о форматировании, присоединенной к CVImageBuffer. Ширина, высота, и codecType должен соответствовать (для CVPixelBuffers типом кодека дают CVPixelBufferGetPixelFormatType(pixelBuffer); для другого CVImageBuffers, codecType должен быть 0). Расширения описания формата должны соответствовать буферные присоединения изображения для всех ключей в списке, возвращенномCMVideoFormatDescriptionGetExtensionKeysCommonWithImageBuffers. если отсутствующий в любом они должны отсутствовать в обоих.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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

CMSampleBufferDataIsReady (_:) CMSampleBufferDataIsReady

Возвраты, действительно ли a CMSampleBuffer's данные готовы.

Объявление

Swift

func CMSampleBufferDataIsReady(_ scuff: CMSampleBuffer!) -> Boolean

Objective C

Boolean CMSampleBufferDataIsReady ( CMSampleBufferRef sbuf );

Параметры

scuff

CMSampleBuffer быть опрошенным.

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

Булевская переменная, указывающая, действительно ли CMSampleBuffer's данные готовы. True возвращается для специальных буферов маркера, eventhough у них нет данных. Если существует ошибка, false возвращается.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferGetAudioBufferListWithRetainedBlockBuffer (_: _: _: _: _: _: _: _:)
    CMSampleBufferGetAudioBufferListWithRetainedBlockBuffer

Создает AudioBufferList содержа данные от CMSampleBuffer, и a CMBlockBuffer какие ссылки (и управляет временем жизни), данные в этом AudioBufferList. Данные могут или не могут быть скопированы, в зависимости от смежности и 16-байтового выравнивания данных CMSampleBuffer. Буферы, помещенные в AudioBufferList, как гарантируют, будут непрерывны. Буферы в AudioBufferList составят 16 байтов, выровненных если kCMSampleBufferFlag_AudioBufferList_Assure16ByteAlignment передается в.

Объявление

Swift

func CMSampleBufferGetAudioBufferListWithRetainedBlockBuffer(_ sbuf: CMSampleBuffer!, _ bufferListSizeNeededOut: UnsafeMutablePointer<UInt>, _ bufferListOut: UnsafeMutablePointer<AudioBufferList>, _ bufferListSize: UInt, _ bbufStructAllocator: CFAllocator!, _ bbufMemoryAllocator: CFAllocator!, _ flags: UInt32, _ blockBufferOut: UnsafeMutablePointer<Unmanaged<CMBlockBuffer>?>) -> OSStatus

Objective C

OSStatus CMSampleBufferGetAudioBufferListWithRetainedBlockBuffer ( CMSampleBufferRef sbuf, size_t *bufferListSizeNeededOut, AudioBufferList *bufferListOut, size_t bufferListSize, CFAllocatorRef bbufStructAllocator, CFAllocatorRef bbufMemoryAllocator, uint32_t flags, CMBlockBufferRef *blockBufferOut );

Параметры

`sbuf`	`CMSampleBuffer` быть полученным доступ.
`bufferListSizeNeededOut`	Получает размер AudioBufferList, требуемого размещать данные. Может быть `NULL`.
`bufferListOut`	Выделенный вызывающей стороной, измеренной, как указано `bufferListSizeNeededOut`. Это заполнено в указателями в сохраненный `blockBufferOut`. Может быть `NULL`.
`bufferListSize`	Размер `bufferListOut` выделенный клиентом. Если bufferListOut не `NULL` и `bufferListSize` недостаточно, `kFigSampleBufferError_ArrayTooSmall` возвращается.
`bbufStructAllocator`	Средство выделения для использования при создании `CMBlockBuffer` структура.
`bbufMemoryAllocator`	Средство выделения для использования для блока памяти, сохраненного `CMBlockBuffer`.
`flags`	Работа управления флагов.
`blockBufferOut`	Сохраненный `CMBlockBuffer`.

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

Код результата. Посмотрите Коды Результата.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferGetAudioStreamPacketDescriptions (_: _: _: _:)
    CMSampleBufferGetAudioStreamPacketDescriptions

Создает массив AudioStreamPacketDescriptions поскольку переменные байты на пакет или переменную структурируют на пакетные аудиоданные в предоставленном CMSampleBuffer. Постоянная скорость передачи, постоянное аудио кадров на пакет приводит к возвращаемому значению noErr и никаких описаний пакета. Этот API является определенным для демонстрационных буферов формата аудио и возвратится kCMSampleBufferError_InvalidMediaTypeForOperation если вызвано с буфером неаудиосэмпла.

Объявление

Swift

func CMSampleBufferGetAudioStreamPacketDescriptions(_ sbuf: CMSampleBuffer!, _ packetDescriptionsSize: UInt, _ packetDescriptionsOut: UnsafeMutablePointer<AudioStreamPacketDescription>, _ packetDescriptionsSizeNeededOut: UnsafeMutablePointer<UInt>) -> OSStatus

Objective C

OSStatus CMSampleBufferGetAudioStreamPacketDescriptions ( CMSampleBufferRef sbuf, size_t packetDescriptionsSize, AudioStreamPacketDescription *packetDescriptionsOut, size_t *packetDescriptionsSizeNeededOut );

Параметры

`sbuf`	`CMSampleBuffer` быть полученным доступ.
`packetDescriptionsSize`	Размер `packetDescriptionsOut` как выделено вызывающей стороной.
`packetDescriptionsOut`	Выделенный вызывающей стороной, получает описания пакета для выборок в `CMSampleBuffer`. Если не-NULL и `packetDescriptionsSize` является слишком маленьким, `kFigSampleBufferError_ArrayTooSmall` возвращается.
`packetDescriptionsSizeNeededOut`	Используемый для запросов для корректного размера, требуемого для `packetDescriptionsOut`. Может быть NULL.

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

Код результата. Посмотрите Коды Результата.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferGetAudioStreamPacketDescriptionsPtr (_: _: _:)
    CMSampleBufferGetAudioStreamPacketDescriptionsPtr

Получает указатель на (и размер) постоянный массив AudioStreamPacketDescriptions поскольку переменные байты на пакет или переменную структурируют на пакетные аудиоданные в предоставленном CMSampleBuffer. Указатель будет оставаться допустимым настолько же долго как sbuf продолжает быть сохраненным. Постоянная скорость передачи, постоянное аудио кадров на пакет приводит к возвращаемому значению noErr и никакие описания пакета. Этот API является определенным для демонстрационных буферов формата аудио и возвратится kCMSampleBufferError_InvalidMediaTypeForOperation если вызвано с буфером неаудиосэмпла.

Объявление

Swift

func CMSampleBufferGetAudioStreamPacketDescriptionsPtr(_ sbuf: CMSampleBuffer!, _ packetDescriptionsPtrOut: UnsafeMutablePointer<UnsafePointer<AudioStreamPacketDescription>>, _ packetDescriptionsSizeOut: UnsafeMutablePointer<UInt>) -> OSStatus

Objective C

OSStatus CMSampleBufferGetAudioStreamPacketDescriptionsPtr ( CMSampleBufferRef sbuf, const AudioStreamPacketDescription **packetDescriptionsPtrOut, size_t *packetDescriptionsSizeOut );

Параметры

`sbuf`	`CMSampleBuffer` быть измененным.
`packetDescriptionsPtrOut`	На выводе, содержит указатель на постоянный массив `AudioStreamPacketDescriptions`. Может быть `NULL`.
`packetDescriptionsSizeOut`	Размер в байтах постоянного массива `AudioStreamPacketDescriptions`. Может быть `NULL`.

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

Код результата. Посмотрите Коды Результата

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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

CMSampleBufferGetDataBuffer (_:) CMSampleBufferGetDataBuffer

Возвращает CMSampleBuffer CMBlockBuffer из данных носителей.

Объявление

Swift

func CMSampleBufferGetDataBuffer(_ sbuf: CMSampleBuffer!) -> CMBlockBuffer!

Objective C

CMBlockBufferRef CMSampleBufferGetDataBuffer ( CMSampleBufferRef sbuf );

Параметры

sbuf

CMSampleBuffer быть опрошенным.

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

CMBlockBuffer из данных носителей. Результат будет NULL если CMSampleBuffer не содержит a CMBlockBuffer, если CMSampleBuffer содержит a CVImageBuffer, или если существует некоторая другая ошибка.

Обсуждение

Вызывающей стороне не принадлежит возвращенный dataBuffer, и должен сохранить его явно, если вызывающая сторона должна поддержать ссылку на него.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.
CMSampleBufferGetDecodeTimeStamp (_:) CMSampleBufferGetDecodeTimeStamp

Возвращает численно самую раннюю метку времени декодирования всех выборок в a CMSampleBuffer.

Объявление

Swift

func CMSampleBufferGetDecodeTimeStamp(_ sbuf: CMSampleBuffer!) -> CMTime

Objective C

CMTime CMSampleBufferGetDecodeTimeStamp ( CMSampleBufferRef sbuf );

Параметры

sbuf

CMSampleBuffer быть опрошенным.

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

Численно самое раннее демонстрационное декодирование устанавливает метку времени в CMSampleBuffer. kCMTimeInvalid если существует ошибка, возвращается.

Обсуждение

Возвращенная метка времени декодирования всегда является меткой времени декодирования первой выборки в буфере, так как даже из порядка представления выборки, как ожидают, будут в порядке декодирования в буфере.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.
CMSampleBufferGetDuration (_:) CMSampleBufferGetDuration

Возвращает общую продолжительность a CMSampleBuffer.

Объявление

Swift

func CMSampleBufferGetDuration(_ sbuf: CMSampleBuffer!) -> CMTime

Objective C

CMTime CMSampleBufferGetDuration ( CMSampleBufferRef sbuf );

Параметры

sbuf

CMSampleBuffer быть опрошенным.

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

Продолжительность CMSampleBuffer. kCMTimeInvalid если существует ошибка, возвращается.

Обсуждение

Если буфер содержит выборок порядка представления, любые разрывы во временной шкале представления не представлены в возвращенной продолжительности. Возвращенная продолжительность является просто суммой всех отдельных демонстрационных продолжительностей.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.
CMSampleBufferGetFormatDescription (_:) CMSampleBufferGetFormatDescription

Возвращает описание формата выборок в a CMSampleBuffer.

Объявление

Swift

func CMSampleBufferGetFormatDescription(_ sbuf: CMSampleBuffer!) -> CMFormatDescription!

Objective C

CMFormatDescriptionRef CMSampleBufferGetFormatDescription ( CMSampleBufferRef sbuf );

Параметры

sbuf

CMSampleBuffer быть опрошенным.

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

Описание формата выборок в CMSampleBuffer. NULL если существует ошибка, возвращается.

Обсуждение

По возврату вызывающей стороне не принадлежит возвращенный formatDesc, и должен сохранить его явно, если вызывающая сторона должна поддержать ссылку на него.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.
CMSampleBufferGetImageBuffer (_:) CMSampleBufferGetImageBuffer

Возвращает CMSampleBuffer CVImageBuffer из данных носителей.

Объявление

Swift

func CMSampleBufferGetImageBuffer(_ sbuf: CMSampleBuffer!) -> CVImageBuffer!

Objective C

CVImageBufferRef CMSampleBufferGetImageBuffer ( CMSampleBufferRef sbuf );

Параметры

sbuf

CMSampleBuffer быть опрошенным.

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

CVImageBuffer из данных носителей. Результат будет NULL если CMSampleBuffer не содержит a CVImageBuffer, если CMSampleBuffer содержит a CMBlockBuffer, или если существует некоторая другая ошибка.

Обсуждение

Вызывающая сторона не владеет возвращенным буфером данных и должна сохранить его явно, если вызывающая сторона должна поддержать ссылку на него.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.
CMSampleBufferGetNumSamples (_:) CMSampleBufferGetNumSamples

Возвращает число выборок носителей в a CMSampleBuffer.

Объявление

Swift

func CMSampleBufferGetNumSamples(_ sbuf: CMSampleBuffer!) -> CMItemCount

Objective C

CMItemCount CMSampleBufferGetNumSamples ( CMSampleBufferRef sbuf );

Параметры

sbuf

CMSampleBuffer быть опрошенным.

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

Число выборок носителей в CMSampleBuffer. Если существует ошибка, 0 возвращается.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.
CMSampleBufferGetOutputDecodeTimeStamp (_:) CMSampleBufferGetOutputDecodeTimeStamp

Возвращается вывод декодируют метку времени CMSampleBuffer.

Объявление

Swift

func CMSampleBufferGetOutputDecodeTimeStamp(_ sbuf: CMSampleBuffer!) -> CMTime

Objective C

CMTime CMSampleBufferGetOutputDecodeTimeStamp ( CMSampleBufferRef sbuf );

Параметры

sbuf

CMSampleBuffer быть опрошенным.

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

Вывод декодирует метку времени CMSampleBuffer. CMInvalidTime если существует ошибка, возвращается.

Обсуждение

Для непротиворечивости с CMSampleBufferGetOutputPresentationTimeStamp, это вычисляется как: OutputPresentationTimeStamp + ((DecodeTimeStamp - PresentationTimeStamp) / SpeedMultiplier).

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.
CMSampleBufferGetOutputDuration (_:) CMSampleBufferGetOutputDuration

Возвращает выходную продолжительность a CMSampleBuffer.

Объявление

Swift

func CMSampleBufferGetOutputDuration(_ sbuf: CMSampleBuffer!) -> CMTime

Objective C

CMTime CMSampleBufferGetOutputDuration ( CMSampleBufferRef sbuf );

Параметры

sbuf

CMSampleBuffer быть опрошенным.

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

Выходная продолжительность CMSampleBuffer. kCMTimeInvalid если существует ошибка, возвращается.

Обсуждение

OutputDuration является продолжительностью минус любая обрезанная продолжительность, все разделенные на SpeedMultiplier: (Продолжительность - TrimDurationAtStart - TrimDurationAtEnd) / SpeedMultiplier.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.
CMSampleBufferGetOutputPresentationTimeStamp (_:) CMSampleBufferGetOutputPresentationTimeStamp

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

Объявление

Swift

func CMSampleBufferGetOutputPresentationTimeStamp(_ sbuf: CMSampleBuffer!) -> CMTime

Objective C

CMTime CMSampleBufferGetOutputPresentationTimeStamp ( CMSampleBufferRef sbuf );

Параметры

sbuf

CMSampleBuffer быть опрошенным.

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

Выходная метка времени представления CMSampleBuffer. kCMTimeInvalid если существует ошибка, возвращается.

Обсуждение

Выходная метка времени представления является временем, в которое декодируемый, обрезанный, расширенный и возможно инвертированные выборки должны начать быть представленным. Если CMSampleBufferGetOutputPresentationTimeStamp был вызван для явной установки вывода PTS, CMSampleBufferGetOutputPresentationTimeStamp возвраты это. В противном случае CMSampleBufferGetOutputPresentationTimeStamp вычисляет его результат как (PresentationTimeStamp + TrimDurationAtStart) если kCMSampleBufferAttachmentKey_Reverse kCFBooleanTrue, когда это вычисляет результат как (PresentationTimeStamp + Продолжительность - TrimDurationAtEnd). Они обычно корректны для нерасширенного, несмещенного воспроизведения. Для общего прямого воспроизведения в масштабированном редактировании, OutputPresentationTimeStamp должен быть установлен в: ((PresentationTimeStamp + TrimDurationAtStart - EditStartMediaTime) / EditSpeedMultiplier) + EditStartTrackTime. Для общего обратного воспроизведения: ((PresentationTimeStamp + Продолжительность - TrimDurationAtEnd - EditStartMediaTime) / EditSpeedMultiplier) + EditStartTrackTime.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferGetOutputSampleTimingInfoArray (_: _: _: _:)
    CMSampleBufferGetOutputSampleTimingInfoArray

Получает массив вывода CMSampleTimingInfo структуры, один для каждой выборки в a CMSampleBuffer.

Объявление

Swift

func CMSampleBufferGetOutputSampleTimingInfoArray(_ sbuf: CMSampleBuffer!, _ timingArrayEntries: CMItemCount, _ timingArrayOut: UnsafeMutablePointer<CMSampleTimingInfo>, _ timingArrayEntriesNeededOut: UnsafeMutablePointer<CMItemCount>) -> OSStatus

Objective C

OSStatus CMSampleBufferGetOutputSampleTimingInfoArray ( CMSampleBufferRef sbuf, CMItemCount timingArrayEntries, CMSampleTimingInfo *timingArrayOut, CMItemCount *timingArrayEntriesNeededOut );

Параметры

`sbuf`	`CMSampleBuffer` быть опрошенным.
`timingArrayEntries`	Число записей в синхронизации массива.
`timingArrayOut`	На выводе, точках к массиву `CMSampleTimingInfo` структуры для получения информации синхронизации.
`timingArrayEntriesNeededOut`	Число записей необходимо для результата.

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

Код результата. Посмотрите Коды Результата.

Обсуждение

Если только один CMSampleTimingInfo структура возвращается, она применяется ко всем выборкам в буфере. См. документацию CMSampleTimingInfo для подробных данных как сингл CMSampleTimingInfo структура может примениться к многократным выборкам. timingArrayOut должен быть выделен вызывающей стороной, и число выделенных записей должно быть передано в timingArrayEntries. Если timingArrayOut NULL, timingArrayEntriesNeededOut возвратит требуемое число записей. Точно так же, если *timingArrayEntriesNeededOut является слишком маленьким, kCMSampleBufferError_ArrayTooSmallбудет возвращен, и timingArrayEntriesNeededOut возвратит требуемое число записей. В любом случае вызывающая сторона может тогда сделать соответственно измеренный timingArrayOut и вызовите снова. Например, вызывающая сторона могла бы передать адрес a CMSampleTimingInfo структура на штабеле (как timingArrayOut), и 1 как timingArrayEntries. Если все выборки являются поддающимися описанию с синглом CMSampleTimingInfo структура (или существует только одна выборка в CMSampleBuffer), этот вызов успешно выполнится. В противном случае это перестанет работать и возвратит число записей, требуемых в timingArrayEntriesNeededOut. Только в этом случае будет вызывающая сторона фактически должна выделить массив. Если нет никакого timingInfo в этом CMSampleBuffer, kCMSampleBufferError_BufferHasNoSampleTimingInfo будет возвращен, и *timingArrayEntriesNeededOut будет установлен в 0.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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

CMSampleBufferGetPresentationTimeStamp (_:) CMSampleBufferGetPresentationTimeStamp

Возвращает численно самую раннюю метку времени представления всех выборок в a CMSampleBuffer.

Объявление

Swift

func CMSampleBufferGetPresentationTimeStamp(_ sbuf: CMSampleBuffer!) -> CMTime

Objective C

CMTime CMSampleBufferGetPresentationTimeStamp ( CMSampleBufferRef sbuf );

Параметры

sbuf

CMSampleBuffer быть опрошенным.

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

Численно самое раннее демонстрационное представление устанавливает метку времени в CMSampleBuffer. kCMTimeInvalid если существует ошибка, возвращается.

Обсуждение

Для выборок «в порядке представления», это - метка времени представления первой выборки. Для выборок порядка представления, это - метка времени представления выборки, которая будет представлена сначала, который является не обязательно первой выборкой в буфере.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferGetSampleAttachmentsArray (_: _:)
    CMSampleBufferGetSampleAttachmentsArray

Возвращает ссылку на a CMSampleBuffer's неизменный массив непостоянных демонстрационных присоединяемых словарей (один словарь на выборку в CMSampleBuffer).

Объявление

Swift

func CMSampleBufferGetSampleAttachmentsArray(_ sbuf: CMSampleBuffer!, _ createIfNecessary: Boolean) -> CFArray!

Objective C

CFArrayRef CMSampleBufferGetSampleAttachmentsArray ( CMSampleBufferRef sbuf, Boolean createIfNecessary );

Параметры

`sbuf`	`CMSampleBuffer` быть опрошенным.
`createIfNecessary`	Указывает, должен ли пустой массив быть создан (если еще нет никаких демонстрационных присоединений).

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

Ссылка на CMSampleBuffer's неизменный массив непостоянных демонстрационных присоединяемых словарей (один словарь на выборку в CMSampleBuffer). NULL если существует ошибка, возвращается

Обсуждение

Присоединения могут тогда быть добавлены/удалены непосредственно вызывающей стороной, с помощью Базовой Основы APIs. По возврату вызывающая сторона не владеет возвращенным массивом присоединяемых словарей и должна сохранить его, если вызывающая сторона должна поддержать ссылку на него. Если еще нет никаких демонстрационных присоединений, и createIfNecessary является истиной, новым CFArray содержа N пустой CFMutableDictionaries возвращается (где N является числом выборок в CMSampleBuffer), так, чтобы присоединения могли быть добавлены непосредственно вызывающей стороной. Если еще нет никаких демонстрационных присоединений, и createIfNecessary ложь, NULL возвращается. Один раз CFArray был создан, последующие вызовы возвратят его, даже если не будет все еще никаких демонстрационных присоединений в массиве.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferGetSampleSize (_: _:)
    CMSampleBufferGetSampleSize

Возвращает размер в байтах указанной выборки в a CMSampleBuffer.

Объявление

Swift

func CMSampleBufferGetSampleSize(_ sbuf: CMSampleBuffer!, _ sampleIndex: CMItemIndex) -> UInt

Objective C

size_t CMSampleBufferGetSampleSize ( CMSampleBufferRef sbuf, CMItemIndex sampleIndex );

Параметры

`sbuf`	`CMSampleBuffer` быть опрошенным
`sampleIndex`	Демонстрационный индекс (0 первая выборка в sbuf),

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

Размер в байтах указанной выборки в CMSampleBuffer. Если демонстрационный индекс не находится в диапазоне 0.. numSamples-1, размер 0 будет возвращен. Если нет никаких объемов выборки в этом CMSampleBuffer, размер 0 будет возвращен. Это будет истиной, например, если выборки в буфере будут состоящими из нескольких несмежных участков (например, нечередующееся аудио, где значения канала для единственной выборки рассеиваются через буфер), или если это CMSampleBuffer содержит a CVImageBuffer.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferGetSampleSizeArray (_: _: _: _:)
    CMSampleBufferGetSampleSizeArray

Получает массив объемов выборки, один для каждой выборки в a CMSampleBuffer.

Объявление

Swift

func CMSampleBufferGetSampleSizeArray(_ sbuf: CMSampleBuffer!, _ sizeArrayEntries: CMItemCount, _ sizeArrayOut: UnsafeMutablePointer<UInt>, _ sizeArrayEntriesNeededOut: UnsafeMutablePointer<CMItemCount>) -> OSStatus

Objective C

OSStatus CMSampleBufferGetSampleSizeArray ( CMSampleBufferRef sbuf, CMItemCount sizeArrayEntries, size_t *sizeArrayOut, CMItemCount *sizeArrayEntriesNeededOut );

Параметры

`sbuf`	`CMSampleBuffer` быть опрошенным.
`sizeArrayEntries`	Число записей в `sizeArray`.
`sizeArrayOut`	Ссылка на массив `size_t` значения для получения объемов выборки.
`sizeArrayEntriesNeededOut`	Число записей необходимо для результата.

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

Код результата. Посмотрите Коды Результата.

Обсуждение

Если только одна запись размера возвращается, все выборки в буфере имеют этот размер. sizeArrayOut должен быть выделен вызывающей стороной, и число выделенных записей должно быть передано в sizeArrayEntries. Если sizeArrayOut NULL, sizeArrayEntriesNeededOut возвратит требуемое число записей. Точно так же, если sizeArrayEntries является слишком маленьким, kCMSampleBufferError_ArrayTooSmall будет возвращен, и sizeArrayEntriesNeededOut возвратит требуемое число записей. Вызывающая сторона может тогда сделать соответственно измеренный sizeArrayOut и вызовите снова. Например, вызывающая сторона могла бы передать адрес a size_t переменная на штабеле (как sizeArrayOut), и 1 как sizeArrayEntries. Если все выборки являются тем же размером (или существует только одна выборка в CMSampleBuffer), этот вызов успешно выполнился бы. В противном случае это перестанет работать и возвратит число записей, требуемых в sizeArrayEntriesNeededOut. Только в этом случае (многократные выборки различных размеров) будет, вызывающая сторона должна выделить массив. 0 записей будут возвращены, если выборки в буфере будут состоящими из нескольких несмежных участков (например, нечередующееся аудио, где значения канала для единственной выборки рассеиваются через буфер). Если нет никаких объемов выборки в этом CMSampleBuffer, kCMSampleBufferError_BufferHasNoSampleSizes будет возвращен, и *sizeArrayEntriesNeededOut будет установлен в 0. Это будет истиной, например, если выборки в буфере будут состоящими из нескольких несмежных участков (например, нечередующееся аудио, где значения канала для единственной выборки рассеиваются через буфер), или если это CMSampleBuffer содержит a CVImageBuffer.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferGetSampleTimingInfo (_: _: _:)
    CMSampleBufferGetSampleTimingInfo

Получает a CMSampleTimingInfo структура, описывающая указанную выборку в a CMSampleBuffer.

Объявление

Swift

func CMSampleBufferGetSampleTimingInfo(_ sbuf: CMSampleBuffer!, _ sampleIndex: CMItemIndex, _ timingInfoOut: UnsafeMutablePointer<CMSampleTimingInfo>) -> OSStatus

Objective C

OSStatus CMSampleBufferGetSampleTimingInfo ( CMSampleBufferRef sbuf, CMItemIndex sampleIndex, CMSampleTimingInfo *timingInfoOut );

Параметры

`sbuf`	`CMSampleBuffer` быть опрошенным.
`sampleIndex`	Демонстрационный индекс (0 первая выборка в `sbuf`).
`timingInfoOut`	На выводе, точках к синглу `CMSampleTimingInfo` структура для получения информации синхронизации.

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

Код результата. Посмотрите Коды Результата.

Обсуждение

Демонстрационно-специфичное CMSampleTimingInfo структура будет возвращена (т.е. с демонстрационно-специфичным presentationTimeStamp и decodeTimeStamp), даже если сингл CMSampleTimingInfo структура использовалась во время создания для описания всех выборок в буфере. timingInfo структура должна быть выделена вызывающей стороной. Если демонстрационный индекс не находится в диапазоне 0.. numSamples-1, kCMSampleBufferError_SampleIndexOutOfRangeбудет возвращен. Если существует нет timingInfo в этом CMSampleBuffer, kCMSampleBufferError_BufferHasNoSampleTimingInfo будет возвращен.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferGetSampleTimingInfoArray (_: _: _: _:)
    CMSampleBufferGetSampleTimingInfoArray

Получает массив CMSampleTimingInfo структуры, один для каждой выборки в a CMSampleBuffer.

Объявление

Swift

func CMSampleBufferGetSampleTimingInfoArray(_ sbuf: CMSampleBuffer!, _ timingArrayEntries: CMItemCount, _ timingArrayOut: UnsafeMutablePointer<CMSampleTimingInfo>, _ timingArrayEntriesNeededOut: UnsafeMutablePointer<CMItemCount>) -> OSStatus

Objective C

OSStatus CMSampleBufferGetSampleTimingInfoArray ( CMSampleBufferRef sbuf, CMItemCount timingArrayEntries, CMSampleTimingInfo *timingArrayOut, CMItemCount *timingArrayEntriesNeededOut );

Параметры

`sbuf`	`CMSampleBuffer` быть опрошенным.
`timingArrayEntries`	Число записей в `timingArray`
`timingArrayOut`	На выводе, точках к массиву `CMSampleTimingInfo` структуры для получения информации синхронизации
`timingArrayEntriesNeededOut`	Число записей необходимо для результата.

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

Код результата. Посмотрите Коды Результата.

Обсуждение

Если только одна структура CMSampleTimingInfo возвращается, она применяется ко всем выборкам в буфере. См. документацию CMSampleTimingInfo для подробных данных как сингл CMSampleTimingInfo структура может примениться к многократным выборкам. timingArrayOut должен быть выделен вызывающей стороной, и число выделенных записей должно быть передано в timingArrayEntries. Если timingArrayOut NULL, timingArrayEntriesNeededOut возвратит требуемое число записей. Точно так же, если *timingArrayEntriesNeededOut is слишком маленький, kCMSampleBufferError_ArrayTooSmallбудет возвращен, и timingArrayEntriesNeededOut возвратит требуемое число записей. В любом случае вызывающая сторона может тогда сделать соответственно измеренный timingArrayOut и вызовите снова. Например, вызывающая сторона могла бы передать адрес a CMSampleTimingInfo структура на штабеле (как timingArrayOut), и 1 как timingArrayEntries. Если все выборки являются поддающимися описанию с синглом CMSampleTimingInfo структура (или существует только одна выборка в CMSampleBuffer), этот вызов успешно выполнится. В противном случае это перестанет работать и возвратит число записей, требуемых в timingArrayEntriesNeededOut. Только в этом случае будет вызывающая сторона фактически должна выделить массив. Если существует нет timingInfo в этом CMSampleBuffer, kCMSampleBufferError_BufferHasNoSampleTimingInfo будет возвращен, и timingArrayEntriesNeededOut будет установлен в 0.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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

CMSampleBufferGetTotalSampleSize (_:) CMSampleBufferGetTotalSampleSize

Возвращает общий размер в байтах демонстрационных данных в a CMSampleBuffer.

Объявление

Swift

func CMSampleBufferGetTotalSampleSize(_ sbuf: CMSampleBuffer!) -> UInt

Objective C

size_t CMSampleBufferGetTotalSampleSize ( CMSampleBufferRef sbuf );

Параметры

sbuf

CMSampleBuffer быть опрошенным.

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

Общий размер в байтах демонстрационных данных в CMSampleBuffer. Если нет никаких объемов выборки в этом CMSampleBuffer, размер 0 будет возвращен.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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

Возвраты CFTypeID из CMSampleBuffer объекты.

Объявление

Swift

func CMSampleBufferGetTypeID() -> CFTypeID

Objective C

CFTypeID CMSampleBufferGetTypeID ( void );

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

CFTypeID из CMSampleBuffer объекты.

Обсуждение

Можно проверить если a CFTypeRef объект фактически a CMSampleBuffer путем сравнения CFGetTypeID(object) с CMSampleBufferGetTypeID().

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.
CMSampleBufferInvalidate (_:) CMSampleBufferInvalidate

Делает демонстрационный буфер недопустимым, вызывая любой установленный обратный вызов аннулирования.

Объявление

Swift

func CMSampleBufferInvalidate(_ sbuf: CMSampleBuffer!) -> OSStatus

Objective C

OSStatus CMSampleBufferInvalidate ( CMSampleBufferRef sbuf );

Параметры

sbuf

CMSampleBuffer быть измененным.

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

Код результата. Посмотрите Коды Результата

Обсуждение

Недопустимый демонстрационный буфер не может использоваться - все средства доступа возвратятся kCMSampleBufferError_Invalidated Это не хорошая идея сделать это к демонстрационному буферу, к которому другой модуль может получать доступ одновременно. Пример использования: обратный вызов аннулирования мог отменить незаконченный I/O.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.
CMSampleBufferIsValid (_:) CMSampleBufferIsValid

Запросы, допустим ли демонстрационный буфер все еще.

Объявление

Swift

func CMSampleBufferIsValid(_ sbuf: CMSampleBuffer!) -> Boolean

Objective C

Boolean CMSampleBufferIsValid ( CMSampleBufferRef sbuf );

Параметры

sbuf

CMSampleBuffer быть опрошенным.

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

Булевская переменная, указывающая, допустим ли демонстрационный буфер все еще.

Обсуждение

Возвращает false если sbuf NULL или CMSampleBufferInvalidate(sbuf) был вызван, истина иначе. Не выполняет вида исчерпывающей проверки демонстрационного буфера.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

Доступный в OS X v10.7 и позже.
CMSampleBufferMakeDataReady (_:) CMSampleBufferMakeDataReady

Делает a CMSampleBuffer готовые данные, путем вызова клиента CMSampleBufferMakeDataReadyCallback.

Объявление

Swift

func CMSampleBufferMakeDataReady(_ sbuf: CMSampleBuffer!) -> OSStatus

Objective C

OSStatus CMSampleBufferMakeDataReady ( CMSampleBufferRef sbuf );

Параметры

sbuf

Изменяемый CMSampleBuffer.

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

Код результата. Посмотрите Коды Результата

Обсуждение

CMSampleBufferMakeDataReadyCallback передается в клиентом во время создания. Это должно возвратиться 0 в случае успеха, и в этом случае, CMSampleBufferMakeDataReady установит готовность данных CMSampleBuffer к истине.

Пример использования: когда пора фактически использовать данные.

Пример подпрограммы обратного вызова: подпрограмма, чтобы вынудить запланированное чтение завершиться.

Если CMSampleBuffer не готов, и существует нет CMSampleBufferMakeDataReadyCallback для вызова kCMSampleBufferError_BufferNotReady будет возвращен. Точно так же, если CMSampleBuffer не готово, и CMSampleBufferMakeDataReadyCallback сбои и возвраты ошибка, kCMSampleBufferError_BufferNotReady будет возвращен.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferSetDataBuffer (_: _:)
    CMSampleBufferSetDataBuffer

Партнеры a CMSampleBuffer с CMBlockBuffer из данных носителей.

Объявление

Swift

func CMSampleBufferSetDataBuffer(_ sbuf: CMSampleBuffer!, _ dataBuffer: CMBlockBuffer!) -> OSStatus

Objective C

OSStatus CMSampleBufferSetDataBuffer ( CMSampleBufferRef sbuf, CMBlockBufferRef dataBuffer );

Параметры

`sbuf`	`CMSampleBuffer` быть измененным.
`dataBuffer`	`CMBlockBuffer` из данных, связываемых с.

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

Код результата. Посмотрите Коды Результата

Обсуждение

Если успешный, эта работа сохраняет dataBuffer. Это позволяет вызывающей стороне выпускать dataBuffer после вызова этого API, если это не имеет никакой дальнейшей потребности сослаться на него. Это - неперезаписываемая работа; это перестанет работать если CMSampleBuffer уже имеет a dataBuffer. Этот API позволяет a CMSampleBuffer для существования, с информацией синхронизации и данными о формате, перед, связанные данные обнаруживаются.

Пример использования: Некоторые мультимедийные службы могут иметь доступ к объему выборки, синхронизации и данным о формате, прежде чем будут считаны данные. Такие службы могут создать CMSampleBuffers с той информацией и вставляют их в очереди рано и используют этот API для присоединения CMBlockBuffers позже, когда данные становятся готовыми.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferSetDataBufferFromAudioBufferList (_: _: _: _: _:)
    CMSampleBufferSetDataBufferFromAudioBufferList

Создает a CMBlockBuffer содержа копию данных от AudioBufferList. Наборы, копирующие как CMSampleBuffer's буфер данных. Получающийся буфер (ы) в демонстрационном буфере составит 16 байтов, выровненных если kCMSampleBufferFlag_AudioBufferList_Assure16ByteAlignment передается в.

Объявление

Swift

func CMSampleBufferSetDataBufferFromAudioBufferList(_ sbuf: CMSampleBuffer!, _ bbufStructAllocator: CFAllocator!, _ bbufMemoryAllocator: CFAllocator!, _ flags: UInt32, _ bufferList: UnsafePointer<AudioBufferList>) -> OSStatus

Objective C

OSStatus CMSampleBufferSetDataBufferFromAudioBufferList ( CMSampleBufferRef sbuf, CFAllocatorRef bbufStructAllocator, CFAllocatorRef bbufMemoryAllocator, uint32_t flags, const AudioBufferList *bufferList );

Параметры

`sbuf`	`CMSampleBuffer` быть измененным.
`bbufStructAllocator`	Средство выделения для использования при создании `CMBlockBuffer` структура.
`bbufMemoryAllocator`	Средство выделения для использования для блока памяти, сохраненного `CMBlockBuffer`.
`flags`	Работа управления флагов.
`bufferList`	Буферный список, данные которого будут скопированы в новое `CMBlockBuffer`.

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

Код результата. Посмотрите Коды Результата

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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

CMSampleBufferSetDataReady (_:) CMSampleBufferSetDataReady

Знаки a CMSampleBuffer's данные как «готовые».

Объявление

Swift

func CMSampleBufferSetDataReady(_ sbuf: CMSampleBuffer!) -> OSStatus

Objective C

OSStatus CMSampleBufferSetDataReady ( CMSampleBufferRef sbuf );

Параметры

sbuf

CMSampleBuffer быть измененным.

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

Код результата. Посмотрите Коды Результата

Обсуждение

Нет никакого способа отменить эту работу. Единственный способ получить «неготовое»CMSampleBuffer должен вызвать CMSampleBufferCreate с dataReady набором параметра ко лжи.

Пример использования: в подпрограмме завершения чтения.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferSetInvalidateCallback (_: _: _:)
    CMSampleBufferSetInvalidateCallback

Наборы CMSampleBuffer’s обратный вызов аннулирования, во время которого вызывают CMSampleBufferInvalidate.

Объявление

Swift

func CMSampleBufferSetInvalidateCallback(_ sbuf: CMSampleBuffer!, _ invalidateCallback: CMSampleBufferInvalidateCallback, _ invalidateRefCon: UInt64) -> OSStatus

Objective C

OSStatus CMSampleBufferSetInvalidateCallback ( CMSampleBufferRef sbuf, CMSampleBufferInvalidateCallback invalidateCallback, uint64_t invalidateRefCon );

Параметры

`sbuf`	`CMSampleBuffer` быть измененным.
`invalidateCallback`	Ссылка на функцию, во время которой вызовут `CMSampleBufferInvalidate`.
`invalidateRefCon`	Ссылочная константа, которая будет передана `invalidateCallback`.

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

Код результата. Посмотрите Коды Результата.

Обсуждение

Демонстрационный буфер может только иметь один обратный вызов аннулирования. Обратный вызов аннулирования НЕ вызывают во время обычного демонстрационного буферного завершения.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferSetOutputPresentationTimeStamp (_: _:)
    CMSampleBufferSetOutputPresentationTimeStamp

Устанавливает выходную метку времени представления, которая будет использоваться вместо расчетного значения.

Объявление

Swift

func CMSampleBufferSetOutputPresentationTimeStamp(_ sbuf: CMSampleBuffer!, _ outputPresentationTimeStamp: CMTime) -> OSStatus

Objective C

OSStatus CMSampleBufferSetOutputPresentationTimeStamp ( CMSampleBufferRef sbuf, CMTime outputPresentationTimeStamp );

Параметры

`sbuf`	`CMSampleBuffer` быть опрошенным
`outputPresentationTimeStamp`	Новое значение для `OutputPresentationTimeStamp`. Передача `kCMTimeInvalid` вернуться к вычислению по умолчанию.

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

Код результата. Посмотрите Коды Результата.

Обсуждение

Выходная метка времени представления является временем, в которое декодируемый, обрезанный, расширенный и возможно инвертированные выборки должны начать быть представленным. По умолчанию это вычисляется путем вызова CMSampleBufferGetOutputPresentationTimeStamp. Вызвать CMSampleBufferSetOutputPresentationTimeStamp явно установить значение для CMSampleBufferGetOutputPresentationTimeStamp возвратиться.

Для общего прямого воспроизведения в масштабированном редактировании OutputPresentationTimeStamp должен быть установлен в:

((PresentationTimeStamp + TrimDurationAtStart - EditStartMediaTime) / EditSpeedMultiplier) + EditStartTrackTime.

Для общего обратного воспроизведения OutputPresentationTimeStamp должен быть установлен в:

((PresentationTimeStamp + Duration - TrimDurationAtEnd - EditStartMediaTime) / EditSpeedMultiplier) + EditStartTrackTime.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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


    
    CMSampleBufferTrackDataReadiness (_: _:)
    CMSampleBufferTrackDataReadiness

Партнеры a CMSampleBuffer's готовность данных с другим CMSampleBuffer's готовность данных.

Объявление

Swift

func CMSampleBufferTrackDataReadiness(_ sbuf: CMSampleBuffer!, _ sbufToTrack: CMSampleBuffer!) -> OSStatus

Objective C

OSStatus CMSampleBufferTrackDataReadiness ( CMSampleBufferRef sbuf, CMSampleBufferRef sbufToTrack );

Параметры

`sbuf`	`CMSampleBuffer` быть измененным.
`sbufToTrack`	`CMSampleBuffer` быть прослеженным.

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

Код результата. Посмотрите Коды Результата.

Обсуждение

После вызова этого API, если CMSampleBufferDataIsReady(sbuf) вызывают, он возвратится sbufToTrack's готовность данных. Если CMSampleBufferMakeDataReady(sbuf) вызывают, он сделает sbufToTrack готовые данные.

Пример использования: Это позволяет разрывать мультивыборку CMSampleBuffer в единственную выборку CMSampleBuffers прежде чем данные готовы. Единственная выборка CMSampleBuffers все отследит мультивыборку CMSampleBuffer's готовность данных.

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

Objective C

@import CoreMedia;

Swift

import CoreMedia

Доступность

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

Типы данных

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

CMSampleBufferRef

Ссылка на неизменное CMSampleBufferRef объект.

Объявление

Swift

typealias CMSampleBufferRef = CMSampleBuffer

Objective C

typedef struct opaqueCMSampleBuffer *CMSampleBufferRef;

Обсуждение

A CMSampleBuffer Базовый объект Основы, содержащий нуль или более сжатый (или несжатый) выборки определенного типа среды (аудио, видео, мультиплексированное, и т.д.).

Доступность

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


      
      CMSampleTimingInfo

Набор информации синхронизации для выборки в a CMSampleBuffer.

Объявление

Swift

struct CMSampleTimingInfo { var duration: CMTime var presentationTimeStamp: CMTime var decodeTimeStamp: CMTime }

Objective C

typedef struct { CMTime duration; CMTime presentationTimeStamp; CMTime decodeTimeStamp; } CMSampleTimingInfo;

Поля

`duration`	Продолжительность выборки. Если единственная структура применяется к каждой из выборок, у них всех есть эта продолжительность.
`presentationTimeStamp`	Время, в которое будет представлена выборка. Если единственная структура применяется к каждой из выборок, у них всех есть эта продолжительность.
`decodeTimeStamp`	Время, в которое будет декодироваться выборка. Если выборки находятся в порядке представления, это должно быть установлено в `kCMInvalidTime`.

Обсуждение

Сингл CMSampleTimingInfo структура может описать каждую отдельную выборку в a CMSampleBuffer, если выборки все имеют ту же продолжительность и находятся в порядке представления без разрывов.

Доступность

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

Константы

Демонстрационные буферные уведомления
Уведомления отправляются демонстрационными буферными объектами.

Объявление

Swift

let kCMSampleBufferNotification_DataBecameReady: CFString! let kCMSampleBufferConduitNotification_InhibitOutputUntil: CFString! let kCMSampleBufferConduitNotification_ResetOutput: CFString! let kCMSampleBufferConduitNotification_UpcomingOutputPTSRangeChanged: CFString! let kCMSampleBufferConsumerNotification_BufferConsumed: CFString!

Objective C

const CFStringRef kCMSampleBufferNotification_DataBecameReady; const CFStringRef kCMSampleBufferConduitNotification_InhibitOutputUntil; const CFStringRef kCMSampleBufferConduitNotification_ResetOutput; const CFStringRef kCMSampleBufferConduitNotification_UpcomingOutputPTSRangeChanged; const CFStringRef kCMSampleBufferConsumerNotification_BufferConsumed;

Константы
- kCMSampleBufferNotification_DataBecameReady
  
  kCMSampleBufferNotification_DataBecameReady
  
  Отправленный на демонстрационном буфере CMSampleBufferSetDataReady функционируйте, когда буфер станет готовым.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferConduitNotification_InhibitOutputUntil
  
  kCMSampleBufferConduitNotification_InhibitOutputUntil
  
  Отправленный на кабелепроводе демонстрационных буферов для объявления о ближайшем разрыве.
  
  Кабелепровод демонстрационных буферов (например, буферная очередь; посмотрите Ссылка CMBufferQueue) отправляет это уведомление, когда происходит разрыв в декодировании. userInfo словарь для этого уведомления содержит kCMSampleBufferConduitNotificationParameter_ResumeTag ключ, значение которого указывает тег, указывающий, когда выведенный должен возобновиться.
  
  Первый демонстрационный буфер после разрыва должен иметь a kCMSampleBufferAttachmentKey_ResumeOutput присоединение, значение которого является тем же числом как тег резюме, о котором объявляют в этом уведомлении. Потребитель должен отбросить выходные данные, пока это не получает этот демонстрационный буфер. Если многократные уведомления об этом типе получены, последний указывает тег резюме.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferConduitNotification_ResetOutput
  
  kCMSampleBufferConduitNotification_ResetOutput
  
  Отправленный на кабелепроводе демонстрационных буферов для запроса аннулирования незаконченных выходных данных.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferConduitNotification_UpcomingOutputPTSRangeChanged
  
  kCMSampleBufferConduitNotification_UpcomingOutputPTSRangeChanged
  
  Отправленный на кабелепроводе видео выборки буферизует для сообщения информации о диапазоне предстоящих выходных меток времени представления.
  
  Эта информация может быть важна для переупорядоченного кадром видео и для определенных типов декодирования, куда выборки передаются в различном порядке от порядка, они будут выведены на экран. Если необходимо обработать кадры в порядке представления, можно использовать эту информацию, чтобы гарантировать, чтобы Вы не обрабатывали кадр слишком рано (т.е. когда существуют предстоящие кадры, которые будут иметь более ранние метки времени представления, чем кадр, который будет обработан).
  
  userInfo словарь для этого уведомления содержит kCMSampleBufferConduitNotificationParameter_UpcomingOutputPTSRangeMayOverlapQueuedOutputPTSRange ключ. Если значение для того ключа kCFBooleanTrue, словарь также содержит один или оба из kCMSampleBufferConduitNotificationParameter_MinUpcomingOutputPTS или kCMSampleBufferConduitNotificationParameter_MaxUpcomingOutputPTS ключи, предоставляющие информацию о диапазоне перекрывающихся меток времени представления.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferConsumerNotification_BufferConsumed
  
  kCMSampleBufferConsumerNotification_BufferConsumed
  
  Дополнительно отправленный, когда используется демонстрационный буфер.
  
  Если демонстрационный буфер имеет значение для kCMSampleBufferAttachmentKey_PostNotificationWhenConsumed присоединение, объект, использующий демонстрационный буфер, должно отправить это уведомление с собой как объект уведомления и присоединяемое значение как userInfo словарь.
  
  Доступный в OS X v10.7 и позже.
Демонстрационные буферные параметры уведомления
Ключи, используемые в userInfo словари уведомлений отправляются демонстрационными буферными объектами.

Объявление

Swift

let kCMSampleBufferConduitNotificationParameter_ResumeTag: CFString! let kCMSampleBufferConduitNotificationParameter_UpcomingOutputPTSRangeMayOverlapQueuedOutputPTSRange: CFString! let kCMSampleBufferConduitNotificationParameter_MinUpcomingOutputPTS: CFString! let kCMSampleBufferConduitNotificationParameter_MaxUpcomingOutputPTS: CFString!

Objective C

const CFStringRef kCMSampleBufferConduitNotificationParameter_ResumeTag; const CFStringRef kCMSampleBufferConduitNotificationParameter_UpcomingOutputPTSRangeMayOverlapQueuedOutputPTSRange; const CFStringRef kCMSampleBufferConduitNotificationParameter_MinUpcomingOutputPTS; const CFStringRef kCMSampleBufferConduitNotificationParameter_MaxUpcomingOutputPTS;

Константы
- kCMSampleBufferConduitNotificationParameter_ResumeTag
  
  kCMSampleBufferConduitNotificationParameter_ResumeTag
  
  Указывает тег, чтобы быть присоединенными к первому демонстрационному буферу после разрыва (тип CFNumber).
  
  Кабелепровод демонстрационных буферов отправляет kCMSampleBufferConduitNotification_InhibitOutputUntil уведомление, когда происходит разрыв в декодировании. Значение для этого ключа будет присоединено к первому демонстрационному буферу после разрыва с помощью kCMSampleBufferAttachmentKey_ResumeOutput присоединение, указывая, что клиенты должны возобновить вывод.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferConduitNotificationParameter_UpcomingOutputPTSRangeMayOverlapQueuedOutputPTSRange
  
  kCMSampleBufferConduitNotificationParameter_UpcomingOutputPTSRangeMayOverlapQueuedOutputPTSRange
  
  Указывает, что метки времени представления предстоящих выходных выборок могут перекрыть те из выборок, поставленных в очередь для вывода (тип CFBoolean).
  
  Этот ключ всегда присутствует в userInfo словарь для kCMSampleBufferConduitNotification_UpcomingOutputPTSRangeChanged уведомление. Если его значение kCFBooleanTrue, существует возможность, что предстоящие кадры могут иметь более ранние метки времени представления, чем кадры, ранее предоставленные для кабелепровода, и словарь также содержит один или оба из kCMSampleBufferConduitNotificationParameter_MinUpcomingOutputPTS или kCMSampleBufferConduitNotificationParameter_MaxUpcomingOutputPTS ключи, предоставляющие дополнительную информацию. Если его значение kCFBooleanFalse, нет такой возможности.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferConduitNotificationParameter_MinUpcomingOutputPTS
  
  kCMSampleBufferConduitNotificationParameter_MinUpcomingOutputPTS
  
  Указывает минимальную метку времени представления предстоящих выходных выборок (тип CFDictionary).
  
  Этот ключ может присутствовать в userInfo словарь для для kCMSampleBufferConduitNotification_UpcomingOutputPTSRangeChanged уведомление в случаях, где предстоящие кадры могут иметь более ранние метки времени, чем ранее предоставленные. Его значение CFDictionary представление a CMTime объект (см. CMTimeMakeFromDictionary).
  
  Или этот ключ или kCMSampleBufferConduitNotificationParameter_MaxUpcomingOutputPTS может быть опущен для отъезда диапазона открытым.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferConduitNotificationParameter_MaxUpcomingOutputPTS
  
  kCMSampleBufferConduitNotificationParameter_MaxUpcomingOutputPTS
  
  Указывает максимальную метку времени представления предстоящих выходных выборок (тип CFDictionary).
  
  Этот ключ может присутствовать в userInfo словарь для для kCMSampleBufferConduitNotification_UpcomingOutputPTSRangeChanged уведомление в случаях, где предстоящие кадры могут иметь более ранние метки времени, чем ранее предоставленные. Его значение CFDictionary представление a CMTime объект (см. CMTimeMakeFromDictionary).
  
  Или этот ключ или kCMSampleBufferConduitNotificationParameter_MinUpcomingOutputPTS может быть опущен для отъезда диапазона открытым.
  
  Доступный в OS X v10.8 и позже.
Демонстрационные присоединяемые ключи
Присоединения связались с отдельными выборками в буфере.

Объявление

Swift

let kCMSampleAttachmentKey_NotSync: CFString! let kCMSampleAttachmentKey_PartialSync: CFString! let kCMSampleAttachmentKey_HasRedundantCoding: CFString! let kCMSampleAttachmentKey_IsDependedOnByOthers: CFString! let kCMSampleAttachmentKey_DependsOnOthers: CFString! let kCMSampleAttachmentKey_EarlierDisplayTimesAllowed: CFString! let kCMSampleAttachmentKey_DisplayImmediately: CFString! let kCMSampleAttachmentKey_DoNotDisplay: CFString!

Objective C

const CFStringRef kCMSampleAttachmentKey_NotSync; const CFStringRef kCMSampleAttachmentKey_PartialSync; const CFStringRef kCMSampleAttachmentKey_HasRedundantCoding; const CFStringRef kCMSampleAttachmentKey_IsDependedOnByOthers; const CFStringRef kCMSampleAttachmentKey_DependsOnOthers; const CFStringRef kCMSampleAttachmentKey_EarlierDisplayTimesAllowed; const CFStringRef kCMSampleAttachmentKey_DisplayImmediately; const CFStringRef kCMSampleAttachmentKey_DoNotDisplay;

Константы
- kCMSampleAttachmentKey_NotSync
  
  kCMSampleAttachmentKey_NotSync
  
  Указывает, является ли выборка синхронизирующей выборкой (тип CFBoolean, ложь по умолчанию).
  
  Синхронизирующая выборка, также известная как ключевой кадр или IDR (Мгновенное Обновление Декодирования), может декодироваться, не требуя, чтобы декодировались любые предыдущие выборки. Выборки после синхронизирующей выборки также не требуют, чтобы декодировались выборки до синхронизирующей выборки. Выборки, как предполагается, являются синхронизирующими выборками по умолчанию — устанавливает значение для этого ключа к kCFBooleanTrue для выборок, которые не должны быть обработаны как синхронизирующие выборки.
  
  Это присоединение считано из и записано в медиа-файлы.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleAttachmentKey_PartialSync
  
  kCMSampleAttachmentKey_PartialSync
  
  Указывает, является ли выборка частичной синхронизирующей выборкой (тип CFBoolean, ложь по умолчанию).
  
  Частичная синхронизирующая выборка может декодироваться, не требуя, чтобы декодировались любые предыдущие выборки. Выборки после двух последовательных частичных синхронизирующих выборок также не требуют, чтобы декодировались выборки до пары. Для обработки выборки как частичной синхронизирующей выборки установите значение kCFBooleanTrue и для этого ключа и для kCMSampleAttachmentKey_NotSync ключ.
  
  Это присоединение считано из и записано в медиа-файлы.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleAttachmentKey_HasRedundantCoding
  
  kCMSampleAttachmentKey_HasRedundantCoding
  
  Указывает, имеет ли выборка избыточное кодирование (тип CFBoolean).
  
  Этот ключ не имеет никакого значения по умолчанию. Если этот ключ не является существующей, избыточной информацией о кодировании для выборки, неизвестно.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleAttachmentKey_IsDependedOnByOthers
  
  kCMSampleAttachmentKey_IsDependedOnByOthers
  
  Указывает, зависят ли другие выборки от этой выборки для декодирования (тип CFBoolean).
  
  Этот ключ не имеет никакого значения по умолчанию. Если этот ключ не является существующей, информацией о зависимостях для выборки, неизвестно. Если этот ключ присутствует, и его значение kCFBooleanFalse, кадр считают сбрасываемым.
  
  Это присоединение считано из и записано в медиа-файлы.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleAttachmentKey_DependsOnOthers
  
  kCMSampleAttachmentKey_DependsOnOthers
  
  Указывает, зависит ли выборка от других выборок для декодирования (тип CFBoolean).
  
  Этот ключ не имеет никакого значения по умолчанию. Если этот ключ не является существующей, информацией о зависимостях для выборки, неизвестно. Значение kCFBooleanFalse указывает, что выборка не зависит от других выборок (например, я структурируют). Значение kCFBooleanTrue указывает, что выборка действительно зависит от других выборок (например, кадр P или B).
  
  Это присоединение считано из и записано в медиа-файлы.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleAttachmentKey_EarlierDisplayTimesAllowed
  
  kCMSampleAttachmentKey_EarlierDisplayTimesAllowed
  
  Указывает, могут ли более поздние выборки иметь более ранние времена дисплея (тип CFBoolean).
  
  Этот ключ не имеет никакого значения по умолчанию. Если этот ключ не присутствует, эта информация для выборки неизвестна.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleAttachmentKey_DisplayImmediately
  
  kCMSampleAttachmentKey_DisplayImmediately
  
  Указывает, должна ли выборка быть сразу выведена на экран (тип CFBoolean, ложь по умолчанию).
  
  Если этот ключ присутствует, выборка должна быть выведена на экран как можно скорее, а не согласно ее метке времени представления. Используйте это присоединение во время выполнения для запроса этого поведения от конвейера дисплея такой как AVSampleBufferDisplayLayer класс.
  
  Это присоединение не записано в медиа-файлы.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleAttachmentKey_DoNotDisplay
  
  kCMSampleAttachmentKey_DoNotDisplay
  
  Указывает, должна ли выборка декодироваться, но не выводиться на экран (тип CFBoolean, ложь по умолчанию).
  
  Используйте это присоединение во время выполнения для запроса этого поведения от конвейера дисплея такой как AVSampleBufferDisplayLayer класс.
  
  Это присоединение не записано в медиа-файлы.
  
  Доступный в OS X v10.7 и позже.
Обсуждение

Можно получить и установить присоединения демонстрационного уровня в демонстрационном буфере с помощью CMSampleBufferGetSampleAttachmentsArray функция.
Демонстрационные буферные присоединяемые ключи
Присоединения буферного уровня связались с демонстрационным буфером.

Объявление

Swift

let kCMSampleBufferAttachmentKey_ResetDecoderBeforeDecoding: CFString! let kCMSampleBufferAttachmentKey_DrainAfterDecoding: CFString! let kCMSampleBufferAttachmentKey_PostNotificationWhenConsumed: CFString! let kCMSampleBufferAttachmentKey_ResumeOutput: CFString! let kCMSampleBufferAttachmentKey_TransitionID: CFString! let kCMSampleBufferAttachmentKey_TrimDurationAtStart: CFString! let kCMSampleBufferAttachmentKey_TrimDurationAtEnd: CFString! let kCMSampleBufferAttachmentKey_SpeedMultiplier: CFString! let kCMSampleBufferAttachmentKey_Reverse: CFString! let kCMSampleBufferAttachmentKey_FillDiscontinuitiesWithSilence: CFString! let kCMSampleBufferAttachmentKey_EmptyMedia: CFString! let kCMSampleBufferAttachmentKey_PermanentEmptyMedia: CFString! let kCMSampleBufferAttachmentKey_DisplayEmptyMediaImmediately: CFString! let kCMSampleBufferAttachmentKey_EndsPreviousSampleDuration: CFString! let kCMSampleBufferAttachmentKey_SampleReferenceURL: CFString! let kCMSampleBufferAttachmentKey_SampleReferenceByteOffset: CFString! let kCMSampleBufferAttachmentKey_GradualDecoderRefresh: CFString!

Objective C

const CFStringRef kCMSampleBufferAttachmentKey_ResetDecoderBeforeDecoding; const CFStringRef kCMSampleBufferAttachmentKey_DrainAfterDecoding; const CFStringRef kCMSampleBufferAttachmentKey_PostNotificationWhenConsumed; const CFStringRef kCMSampleBufferAttachmentKey_ResumeOutput; const CFStringRef kCMSampleBufferAttachmentKey_TransitionID; const CFStringRef kCMSampleBufferAttachmentKey_TrimDurationAtStart; const CFStringRef kCMSampleBufferAttachmentKey_TrimDurationAtEnd; const CFStringRef kCMSampleBufferAttachmentKey_SpeedMultiplier; const CFStringRef kCMSampleBufferAttachmentKey_Reverse; const CFStringRef kCMSampleBufferAttachmentKey_FillDiscontinuitiesWithSilence; const CFStringRef kCMSampleBufferAttachmentKey_EmptyMedia; const CFStringRef kCMSampleBufferAttachmentKey_PermanentEmptyMedia; const CFStringRef kCMSampleBufferAttachmentKey_DisplayEmptyMediaImmediately; const CFStringRef kCMSampleBufferAttachmentKey_EndsPreviousSampleDuration; const CFStringRef kCMSampleBufferAttachmentKey_SampleReferenceURL; const CFStringRef kCMSampleBufferAttachmentKey_SampleReferenceByteOffset; const CFStringRef kCMSampleBufferAttachmentKey_GradualDecoderRefresh;

Константы
- kCMSampleBufferAttachmentKey_ResetDecoderBeforeDecoding
  
  kCMSampleBufferAttachmentKey_ResetDecoderBeforeDecoding
  
  Указывает, должен ли демонстрационный буфер быть сброшен прежде, чем декодировать (тип CFBoolean, ложь по умолчанию).
  
  Это присоединение используется во время выполнения, чтобы указать, что выборка следует, перерыв декодируют последовательность и что является надлежащим сбросить декодер прежде, чем декодировать эту выборку.
  
  Это присоединение не записано в медиа-файлы.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_DrainAfterDecoding
  
  kCMSampleBufferAttachmentKey_DrainAfterDecoding
  
  Указывает, должен ли демонстрационный буфер быть истощен после декодирования типа CFBoolean, ложь по умолчанию).
  
  Это присоединение используется во время выполнения, чтобы указать, что выборка предшествует, перерыв декодируют последовательность и что является надлежащим истощить декодер после декодирования этой выборки.
  
  Это присоединение не записано в медиа-файлы.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_PostNotificationWhenConsumed
  
  kCMSampleBufferAttachmentKey_PostNotificationWhenConsumed
  
  Если настоящее, указывает, что декодируют конвейеры, должен отправить уведомление при потреблении демонстрационного буфера (тип CFDictionary).
  
  Это присоединение используется во время выполнения, чтобы запросить, чтобы конвейер декодирования отправил a kCMSampleBufferConsumerNotification_BufferConsumed уведомление, когда используется этот демонстрационный буфер. Значение для этого ключа используется в качестве userInfo словарь в уведомлении.
  
  Это присоединение не записано в медиа-файлы.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_ResumeOutput
  
  kCMSampleBufferAttachmentKey_ResumeOutput
  
  Если настоящее, указывает, что выводит, должен быть возобновлен после разрыва CFBoolean, ложь по умолчанию).
  
  Это присоединение используется во время выполнения, чтобы запросить, чтобы конвейер декодирования продолжил производить вывод после того, как разрыв объявил об использовании kCMSampleBufferConduitNotification_InhibitOutputUntil уведомление.
  
  Это присоединение не записано в медиа-файлы.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_TransitionID
  
  kCMSampleBufferAttachmentKey_TransitionID
  
  Отмечает переход от одного источника буферов другому.
  
  Например, во время сплошного воспроизведения списка песен, это присоединение отмечает первый буфер от следующей песни. Если это присоединение находится на буфере, содержащем выборки, первый следующий буфер, содержащий выборки, является буфером, содержащим первые выборки от следующей песни. Значение этого присоединения является a CFTypeRef. Этот идентификатор перехода должен быть уникальным в списке воспроизведения, таким образом, каждый переход в списке воспроизведения является уникально идентифицируемым. A CFNumberRef ответьте, который постепенно увеличивается с каждым переходом, простой пример.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_TrimDurationAtStart
  
  kCMSampleBufferAttachmentKey_TrimDurationAtStart
  
  Продолжительность, которая должна быть удалена в начале демонстрационного буфера после декодирования.
  
  Если это присоединение не присутствует, продолжительность для обрезки является нулем (ничто удаленное). Это - a CMTime в Базовой Основе словарь форматируют, как сделано CMTimeCopyAsDictionary; использовать CMTimeMakeFromDictionary преобразовать в CMTime. В случаях, где весь вывод после декодирования демонстрационного буфера должен быть отброшен (например, выборки только декодируются к началу декодер) обычное соглашение состоит в том, чтобы установить kCMSampleBufferAttachmentKey_TrimDurationAtStart к целой продолжительности а не установить a kCMSampleBufferAttachmentKey_TrimDurationAtEnd присоединение.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_TrimDurationAtEnd
  
  kCMSampleBufferAttachmentKey_TrimDurationAtEnd
  
  Продолжительность, которая должна быть удалена в конце демонстрационного буфера после декодирования.
  
  Если это присоединение не присутствует, продолжительность для обрезки является нулем (ничто удаленное). Это - a CMTime в Базовой Основе словарь форматируют, как сделано CMTimeCopyAsDictionary; использовать CMTimeMakeFromDictionary преобразовать в CMTime.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_SpeedMultiplier
  
  kCMSampleBufferAttachmentKey_SpeedMultiplier
  
  Фактор, которым должно быть ускорено представление демонстрационного буфера (тип CFNumber, значение по умолчанию 1.0).
  
  Для нормального воспроизведения множитель скорости был бы 1.0 (который используется, если это присоединение не присутствует); для воспроизведения с удвоенной скоростью множитель скорости был бы 2.0, который разделил бы на два выходную продолжительность. Коэффициенты умножения скорости вступают в силу после обрезки; посмотрите CMSampleBufferGetOutputDuration. Обратите внимание на то, что это присоединение преимущественно предоставляет информацию о расширяющем продолжительность эффекте: по умолчанию это должно быть реализовано преобразованием уровня, но другие присоединения могут указать более богатые операции протяжения — например, масштабировавшись без сдвига подачи, или передать сдвиг, не изменяя продолжительность. Последовательности умноженных на скорость демонстрационных буферов должны иметь явные метки времени для разъяснения, когда каждый должен быть выведен (см. CMSampleBufferSetOutputPresentationTimeStamp).
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_Reverse
  
  kCMSampleBufferAttachmentKey_Reverse
  
  Указывает, что декодируемое содержание демонстрационного буфера должно быть инвертировано (тип CFBoolean, ложь по умолчанию).
  
  Если это присоединение не присутствует, демонстрационный буфер должен играться вперед, как обычно. Реверсирование происходит после множителей скорости и обрезки.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_FillDiscontinuitiesWithSilence
  
  kCMSampleBufferAttachmentKey_FillDiscontinuitiesWithSilence
  
  Заполните различие между несмежными демонстрационными буферами с тишиной (тип CFBoolean, ложь по умолчанию).
  
  Если демонстрационный буфер вводит буферную очередь и метку времени представления между предыдущим буфером, и буфер с этим присоединением являются несмежными, обрабатывают разрыв путем генерации тишины для разницы во времени.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_EmptyMedia
  
  kCMSampleBufferAttachmentKey_EmptyMedia
  
  Отмечает преднамеренно пустой интервал в последовательности выборок (тип CFBoolean, ложь по умолчанию).
  
  Когда пустой интервал начинается, выходная метка времени представления демонстрационного буфера указывает. Демонстрационные буферы маркера с этим присоединением используются для объявления о поступлении пустых редактирований.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_PermanentEmptyMedia
  
  kCMSampleBufferAttachmentKey_PermanentEmptyMedia
  
  Отмечает конец последовательности выборок (тип CFBoolean, ложь по умолчанию).
  
  Выборка маркера буферизует с этим присоединением в дополнение к kCMSampleBufferAttachmentKey_EmptyMedia используются, чтобы указать, что не ожидаются никакие дальнейшие выборки.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_DisplayEmptyMediaImmediately
  
  kCMSampleBufferAttachmentKey_DisplayEmptyMediaImmediately
  
  Говорит, что пустой маркер должен быть сразу исключен из очереди независимо от его метки времени (тип CFBoolean, ложь по умолчанию).
  
  Выборка маркера буферизует с этим присоединением в дополнение к kCMSampleBufferAttachmentKey_EmptyMedia используются, чтобы сказать, что пустой демонстрационный буфер должен быть сразу исключен из очереди независимо от его метки времени. Это присоединение должно только использоваться с демонстрационными буферами с kCMSampleBufferAttachmentKey_EmptyMedia присоединение.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_EndsPreviousSampleDuration
  
  kCMSampleBufferAttachmentKey_EndsPreviousSampleDuration
  
  Указывает, что метка времени декодирования демонстрационного буфера может использоваться для определения продолжительности предыдущего демонстрационного буфера (тип CFBoolean, ложь по умолчанию).
  
  Демонстрационные буферы маркера с этим присоединением могут использоваться в ситуациях, куда демонстрационные буферы передаются, прежде чем их продолжительность известна. В таких ситуациях обычно получатель может использовать метку времени каждого демонстрационного буфера для вычисления продолжительности предыдущего демонстрационного буфера. Демонстрационный буфер маркера с этим присоединением отправляется для обеспечения метки времени для вычисления продолжительности заключительного демонстрационного буфера.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_SampleReferenceURL
  
  kCMSampleBufferAttachmentKey_SampleReferenceURL
  
  Указывает URL, где демонстрационные данные (тип CFURL).
  
  Этот ключ только используется для демонстрационных буферов, представляющих демонстрационные ссылки.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_SampleReferenceByteOffset
  
  kCMSampleBufferAttachmentKey_SampleReferenceByteOffset
  
  Указывает байтовое смещение, при котором начинаются демонстрационные данные (тип CFNumber).
  
  Этот ключ только используется для демонстрационных буферов, представляющих демонстрационные ссылки. Его значение является байтовым смещением с начала данных в URL, на который ссылаются, к непрерывным демонстрационным данным.
  
  Доступный в OS X v10.7 и позже.
- kCMSampleBufferAttachmentKey_GradualDecoderRefresh
  
  kCMSampleBufferAttachmentKey_GradualDecoderRefresh
  
  Указывает количество обновления декодера (тип CFNumber).
  
  Демонстрационные буферы с этим присоединением могут использоваться для идентификации аудио количества обновления декодера.
  
  Доступный в OS X v10.7 и позже.
Обсуждение

Чтобы получить и установить присоединения буферного уровня демонстрационного буфера, используйте функции, описанные в Ссылке CMAttachment.

Коды результата

Эта таблица приводит коды результата, определенные для CMSampleBuffer APIs.


Код результата	Значение	Описание
noErr	0	Никакая ошибка.
kCMSampleBufferError_AllocationFailed	- 12730	Указывает, что выделение перестало работать.
kCMSampleBufferError_RequiredParameterMissing	- 12731	Указывает это `NULL` или `0` был передан для обязательного параметра.
kCMSampleBufferError_AlreadyHasDataBuffer	- 12732	Указывает, что была предпринята попытка для установки буфера данных на a `CMSampleBuffer` это уже имеет тот.
kCMSampleBufferError_BufferNotReady	- 12733	Указывает, что не мог быть приготовлен буфер.
kCMSampleBufferError_SampleIndexOutOfRange	- 12734	Указывает, что демонстрационный индекс не был между `0` и `numSamples-1`, включительно.
kCMSampleBufferError_BufferHasNoSampleSizes	- 12735	Указывает, что была попытка получить информацию объема выборки, когда не было ни одного.
kCMSampleBufferError_BufferHasNoSampleTimingInfo	- 12736	Указывает, что была попытка получить демонстрационную информацию синхронизации, когда не было ни одного.
kCMSampleBufferError_ArrayTooSmall	- 12737	Указывает, что выходной массив не был достаточно большим для массива, который требуют.
kCMSampleBufferError_InvalidEntryCount	- 12738	Указывает, что информация синхронизации или количество записи массива размера не были `0`, `1`, или `numSamples`.
kCMSampleBufferError_CannotSubdivide	- 12739	Указывает, что демонстрационный буфер не содержит объемы выборки. Это может произойти, когда выборки в буфере являются состоящими из нескольких несмежных участков (например, в нечередующемся аудио, где значения канала для единственной выборки рассеиваются через буфер).
kCMSampleBufferError_SampleTimingInfoInvalid	- 12740	Указывает, что буфер неожиданно содержит нечисловую демонстрационную информацию синхронизации.
kCMSampleBufferError_InvalidMediaTypeForOperation	- 12741	Указывает, что тип среды, указанный описанием формата, не допустим для данной работы.
kCMSampleBufferError_InvalidSampleData	- 12742	Указывает, что Буфер содержит неправильных данных. Это значение только возвращается `CMSampleBuffer` функции, проверяющие его демонстрационные данные.
kCMSampleBufferError_InvalidMediaFormat	- 12743	Указывает, что формат данных носителей не соответствует данное описание формата. Например, описание формата соединилось с a `CVImageBuffer` это перестало работать `CMVideoFormatDescriptionMatchesImageBuffer`.
kCMSampleBufferError_Invalidated	- 12744	Указывает, что демонстрационный буфер был лишен законной силы.