Ссылка CMBufferQueue

Этот документ описывает API для создания и управления CMBufferQueue структуры.

CMBufferQueues Базовые объекты Основы, реализующие очередь синхронизированных буферов. Эти буферы могут иметь любой Базовый Основанный на основе тип (CFTypeRef), но должен иметь понятие продолжительности. Во время CMBufferQueue создание, ряд обратных вызовов предоставлен, один из которых является требуемым обратным вызовом, возвращающим продолжительность Базового Основанного на основе буферного объекта. Стандартная структура обратного вызова для CMSampleBuffers предоставлен как удобство. Эти обратные вызовы вызывают синхронно из различного CMBufferQueue APIs, на потоке, который названный API.

CMBufferQueues разработаны, чтобы быть считанным и записанным из различных потоков в модели производителя/потребителя. В то время как это обычно - два потока (один producer/enqueuer, один dequeuer/consumer), CMBufferQueues может обслужить любое число буферов постановки в очередь и/или исключения из очереди потоков. В CMBufferQueue APIs, все операции (не просто CMBufferQueueEnqueue и CMBufferQueueDequeueAndRetain, но Comparing CMBufferQueue, CMBufferQueueInstallTrigger и т.д.), сделаны атомарными при помощи единственного взаимного исключения (одно взаимное исключение на создаваемый объект очереди).

По умолчанию, a CMBufferQueue если обратный вызов сравнения предоставлен, получающееся, очередь FIFO, но CMBufferQueue будет сортирован на основе того обратного вызова. Например, можно было бы создать a CMBufferQueue где буферы ставятся в очередь в порядке декодирования и исключаются из очереди в порядке представления путем обеспечения обратного вызова сравнения, к которому добавляют метку времени виды представлением.

CMBufferQueues сохраните ставивший в очередь буфер во время, Ставят в очередь, таким образом, клиент может выпустить буфер, если это не имеет никакой дальнейшей потребности ссылки. Во время CMBufferQueueDequeueAndRetain, буфер сохранен от имени клиента и выпущен очередью. Результат состоит в том, что сохранить количество остается тем же, и владение буфера передается от очереди клиенту.

Если предоставленный обратным вызовом буферной готовности, CMBufferQueues может проверить на буферную готовность во время CMBufferQueueDequeueIfDataReadyAndRetain. Если тот обратный вызов не предоставлен, все буферы, как предполагается, готовы, и нет никакого различия между CMBufferQueueDequeueAndRetain, и CMBufferQueueDequeueIfDataReadyAndRetain.

CMBufferQueues также реализация CMBufferQueueIsEmpty и CMBufferQueueTestTrigger, с помощью добирающихся дополнительных обратных вызовов декодируют и метки времени представления от буфера. Если или или оба из этих обратных вызовов не предоставлен, kCMTimeInvalid будет возвращен для недостающей метки (ок) времени.

CMBufferQueues может быть отмечен с концом данных (CMBufferQueueMarkEndOfData). Один раз так отмечено, далее ставит в очередь, перестанет работать, и как только все буферы были исключены из очереди, очередь постоянно пуста («в конце данных»), пока не вызывают Сброс. Сброс освобождает очередь и отменяет маркировку конца данных.

Текущий статус a CMBufferQueue может быть опрошен. Можно протестировать на пустоту (CMBufferQueueCreate), текущая продолжительность очереди (“Comparing CMBufferQueue”), и состояние конца данных (CMBufferQueueContainsEndOfData и CMBufferQueueIsAtEndOfData).

Можно установить триггерные обратные вызовы (использование CMBufferQueueInstallTrigger) получить уведомления о различных изменениях состояния очереди, такие как “продолжительность становится меньше чем 1 секундой”. Очередь не может быть изменена во время триггерного обратного вызова, но она может быть опрошена. Триггерные условия могут быть протестированы явно также (CMBufferQueueTestTrigger). Триггеры с NULL обратные вызовы могут быть добавлены к очереди для этого типа использования, но триггерам с обратными вызовами можно было также протестировать их условия явно.

Триггерные обратные вызовы можно вызвать от любого CMBufferQueue API, изменяющий общую продолжительность очереди (те, которые Ставят в очередь/Исключают из очереди/Сбрасывают). Триггерные обратные вызовы вызывают синхронно на потоке который названные API.

Изменение состояния очереди всегда из триггерного обратного вызова запрещается и перестанет работать, возвращаясь kCMBufferQueueError_CannotModifyQueueFromTriggerCallback.

Попытка Ставить в очередь на полную очередь или Исключить из очереди от пустой очереди не блокирует, но сразу возвратится с ошибкой (или с a NULL буфер). Триггеры должны быть установлены клиентом для управления знанием клиента обилия очереди. Использованию повторных повторений (опрос) обескураживают как неэффективное использование ресурсов.