Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка DRCoreBurn.h

Опции
Развертывание Target:

На этой странице
Язык:

Ссылка DRCoreBurn.h

Запишите интерфейсы объекта для Записи Диска.

Включенные заголовки

  • <CoreServices/CoreServices.h>

  • <DiscRecording/DRCoreObject.h>

  • <DiscRecording/DRCoreTrack.h>

  • <DiscRecording/DRCoreDevice.h>

  • <AvailabilityMacros.h>

Функции

  • Останавливает запись.

    Объявление

    Swift

    func DRBurnAbort(_ burn: DRBurn!)

    Objective C

    void DRBurnAbort ( DRBurnRef burn );

    Параметры

    burn

    Запись, которая должна быть остановлена. Если этот параметр не содержит допустимый объект DRBurn, поведение не определено.

    Обсуждение

    Прерывание записи может сделать CD неприменимым в зависимости от объема данных записанный. Если ничто не было записано тогда, диск может быть снова использован как пробел. Если все данные были записаны (и проверка происходит, например), тогда, диск будет применим, и данные будут неповреждены, если проверка не перестала бы работать. Иначе, диск будет неприменим.

    Если запись не запустилась или уже завершилась, эта функция ничего не делает.

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

  • Получает прогресс и состояние записи.

    Объявление

    Swift

    func DRBurnCopyStatus(_ burn: DRBurn!) -> Unmanaged<CFDictionary>!

    Objective C

    CFDictionaryRef DRBurnCopyStatus ( DRBurnRef burn );

    Параметры

    burn

    Запись, для которой требуется состояние. Если этот параметр не является допустимым объектом DRBurn, поведение не определено.

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

    Возвращает ссылку на объект CFDictionary. Ссылка неявно сохраняется вызывающей стороной. Это - тот же словарь, отправленный наблюдателям kDRBurnStatusChangedNotification уведомления.

    Обсуждение

    Возвращает объект CFDictionary, содержащий прогресс и состояние записи. Этот словарь будет содержать состояние, завершенный процент, и любые ошибки сообщил.

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

  • Создает новую запись.

    Объявление

    Swift

    func DRBurnCreate(_ device: DRDevice!) -> Unmanaged<DRBurn>!

    Objective C

    DRBurnRef DRBurnCreate ( DRDeviceRef device );

    Параметры

    device

    Ссылка на устройство для записи к. Если этот параметр не является допустимым DRDevice, поведение не определено.

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

    Ссылка возвратов на новый экземпляр DRBurn.

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

  • Получает ссылку на устройство, связанное с записью.

    Объявление

    Swift

    func DRBurnGetDevice(_ burn: DRBurn!) -> Unmanaged<DRDevice>!

    Objective C

    DRDeviceRef DRBurnGetDevice ( DRBurnRef burn );

    Параметры

    burn

    Запись, для которой можно получить ссылку устройства. Если этот параметр не является допустимым объектом DRBurn, поведение не определено.

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

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

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

  • Получает свойства записи.

    Объявление

    Swift

    func DRBurnGetProperties(_ burn: DRBurn!) -> Unmanaged<CFDictionary>!

    Objective C

    CFDictionaryRef DRBurnGetProperties ( DRBurnRef burn );

    Параметры

    burn

    Запись, для которой можно получить свойства. Если этим параметром является NULL, поведение не определено.

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

    Возвращает ссылку на объект CFDictionary. Вызывающая сторона неявно не сохраняет ссылку и не ответственна за выпуск его.

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

  • Получает идентификатор типа всех объектов DRBurn.

    Объявление

    Swift

    func DRBurnGetTypeID() -> CFTypeID

    Objective C

    CFTypeID DRBurnGetTypeID ( void );

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

    Базовый идентификатор типа Основы.

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

  • Устанавливает свойства записи.

    Объявление

    Swift

    func DRBurnSetProperties(_ burn: DRBurn!, _ properties: CFDictionary!)

    Objective C

    void DRBurnSetProperties ( DRBurnRef burn, CFDictionaryRef properties );

    Параметры

    burn

    Запись, для которой можно установить свойства. Если этот параметр не является допустимым объектом DRBurn, поведение не определено.

    properties

    Ссылка на объект CFDictionary. Если этот параметр не ссылается на допустимый объект CFDictionary, поведение не определено.

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

  • Пишет указанное расположение дорожек в диск.

    Объявление

    Swift

    func DRBurnWriteLayout(_ burn: DRBurn!, _ layout: AnyObject!) -> OSStatus

    Objective C

    OSStatus DRBurnWriteLayout ( DRBurnRef burn, CFTypeRef layout );

    Параметры

    burn

    Запись, которая должна быть запущена. Если этот параметр не является допустимым объектом DRBurn, поведение не определено.

    layout

    Объект, описывающий расположение данных по диску. Наиболее распространенное расположение состоит из объекта CFArray, элементы которого являются объектами DRTrack. Другие параметры макета являются одиноким объектом DRTrack и CFArray гомогенного CFArrays DRTracks. Если расположение не является одним из этих видов, или если какой-либо из объектов не допустим, поведение этой функции не определено.

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

    Код ошибки, указывающий, могла ли бы начаться запись.

    Обсуждение

    Объект передал в эту функцию, описывает расположение диска. Существует три возможных конфигурации расположения:

    • Для многосеансной записи расположение должно быть допустимым объектом CFArray, содержащим многократные CFArrays, каждый из которых содержит один или несколько допустимых объектов DRTrack.

    • Для односеансной, многодорожечной записи расположение должно быть допустимым объектом CFArray, содержащим один или несколько допустимых объектов DRTrack.

    • Для односеансной, однодорожечной записи расположение должно быть допустимым объектом DRTrack.

    Если или этих конфигураций не встречены или значения, содержавшиеся в массиве (ах), не допустимые объекты DRTrack, поведение не определено.

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

Типы данных

Посмотрите раздел Overview выше для документации уровня заголовка.

  • Объявление

    Swift

    typealias DRBurnRef = DRBurn

    Objective C

    typedef struct __DRBurn* DRBurnRef;

    Обсуждение

    Ссылка на экземпляры DRBurn.

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

Константы

Посмотрите раздел Overview выше для документации уровня заголовка.

  • Объявление

    Swift

    let DRBurnDoubleLayerL0DataZoneBlocksKey: NSString! let kDRBurnAppendableKey: CFString! let kDRBurnCompletionActionEject: CFString! let kDRBurnCompletionActionKey: CFString! let kDRBurnCompletionActionMount: CFString! let kDRBurnDoubleLayerL0DataZoneBlocksKey: CFString! let kDRBurnFailureActionEject: CFString! let kDRBurnFailureActionKey: CFString! let kDRBurnFailureActionNone: CFString! let kDRBurnOverwriteDiscKey: CFString! let kDRBurnRequestedSpeedKey: CFString! let kDRBurnStatusChangedNotification: CFString! let kDRBurnStrategyBDDAO: CFString! let kDRBurnStrategyCDSAO: CFString! let kDRBurnStrategyCDTAO: CFString! let kDRBurnStrategyDVDDAO: CFString! let kDRBurnStrategyIsRequiredKey: CFString! let kDRBurnStrategyKey: CFString! let kDRBurnTestingKey: CFString! let kDRBurnUnderrunProtectionKey: CFString! let kDRBurnVerifyDiscKey: CFString! let kDRCDTextKey: CFString! let kDRMediaCatalogNumberKey: CFString! let kDRSynchronousBehaviorKey: CFString!

    Objective C

    extern const CFStringRef kDRBurnDoubleLayerL0DataZoneBlocksKey ; extern const CFStringRef kDRBurnAppendableKey ; extern const CFStringRef kDRBurnCompletionActionEject ; extern const CFStringRef kDRBurnCompletionActionKey ; extern const CFStringRef kDRBurnCompletionActionMount ; extern const CFStringRef kDRBurnDoubleLayerL0DataZoneBlocksKey ; extern const CFStringRef kDRBurnFailureActionEject ; extern const CFStringRef kDRBurnFailureActionKey ; extern const CFStringRef kDRBurnFailureActionNone ; extern const CFStringRef kDRBurnOverwriteDiscKey ; extern const CFStringRef kDRBurnRequestedSpeedKey ; extern const CFStringRef kDRBurnStatusChangedNotification ; extern const CFStringRef kDRBurnStrategyBDDAO ; extern const CFStringRef kDRBurnStrategyCDSAO ; extern const CFStringRef kDRBurnStrategyCDTAO ; extern const CFStringRef kDRBurnStrategyDVDDAO ; extern const CFStringRef kDRBurnStrategyIsRequiredKey ; extern const CFStringRef kDRBurnStrategyKey ; extern const CFStringRef kDRBurnTestingKey ; extern const CFStringRef kDRBurnUnderrunProtectionKey ; extern const CFStringRef kDRBurnVerifyDiscKey ; extern const CFStringRef kDRCDTextKey ; extern const CFStringRef kDRMediaCatalogNumberKey ; extern const CFStringRef kDRSynchronousBehaviorKey ;

    Константы

    • DRBurnDoubleLayerL0DataZoneBlocksKey

      DRBurnDoubleLayerL0DataZoneBlocksKey

      Этот ключ свойства записи соответствует CFNumber, содержащему число блоков, желаемых для зоны данных уровня 0 на двойном уровне перезаписываемый диск.

      Размер зоны данных уровня 0 диктует, где точка перехода от уровня 0 до уровня 1. Если этот ключ будет присутствовать, то размер зоны данных будет установлен до запуска записи с помощью значения для этого ключа. Если это не будет присутствовать, то зона данных уровня 0 по умолчанию будет использоваться (половина доступных блоков на пустом диске).

      Точка перехода может быть указана два пути. Если значение, указанное в этом ключе, будет больше, чем 1,0, то это будет определять абсолютный номер блока для точки перехода. В этом случае номер блока должен быть кратным числом 16 и по крайней мере 40000-й на спецификацию. Если значение будет меньше чем 1,0, то оно укажет процент записи, которая должна находиться на уровне 0. Типичное значение 0.5, определяя половину записи для каждого уровня. Значение 0,0 или 1.0 не изменит точку перехода уровня 0.

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

    • kDRBurnAppendableKey

      kDRBurnAppendableKey

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

      Этот ключ свойства записи соответствует объекту CFBoolean, содержащему флаг, указывающий, должен ли диск все еще быть appendable после записи. Если этот ключ не будет присутствовать, то запись примет значение по умолчанию к значению false и диск будет закрыт.

      Большинство форматов CD не позволяет открытые диски, и много типов читателей CD не будут работать с дисками, которые оставляют appendable. Не изменяйте значение этого ключа, если Вы не понимаете последствий.

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

    • kDRBurnCompletionActionEject

      kDRBurnCompletionActionEject

      Указание объекта CFString, что диск должен извлечь диск, когда завершается запись.

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

    • kDRBurnCompletionActionKey

      kDRBurnCompletionActionKey

      Действие, чтобы брать завершение записи, со значением по умолчанию извлекаются.

      Этот ключ свойства записи соответствует объекту CFString, содержащему одно из доступных действий завершения для обработки содержимого диска.

      Если этот ключ не будет присутствовать, то запись примет значение по умолчанию к значению kDRBurnCompletionActionEject, и диск будет извлечен.

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

    • kDRBurnCompletionActionMount

      kDRBurnCompletionActionMount

      Указание объекта CFString, что механизм Записи Диска должен смонтировать диск на рабочем столе, когда завершается запись.

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

    • kDRBurnDoubleLayerL0DataZoneBlocksKey

      kDRBurnDoubleLayerL0DataZoneBlocksKey

      Этот ключ свойства записи соответствует CFNumber, содержащему число блоков, желаемых для зоны данных уровня 0 на двойном уровне перезаписываемый диск.

      Размер зоны данных уровня 0 диктует, где точка перехода от уровня 0 до уровня 1. Если этот ключ будет присутствовать, то размер зоны данных будет установлен до запуска записи с помощью значения для этого ключа. Если это не будет присутствовать, то зона данных уровня 0 по умолчанию будет использоваться (половина доступных блоков на пустом диске).

      Точка перехода может быть указана два пути. Если значение, указанное в этом ключе, будет больше, чем 1,0, то это будет определять абсолютный номер блока для точки перехода. В этом случае номер блока должен быть кратным числом 16 и по крайней мере 40000-й на спецификацию. Если значение будет меньше чем 1,0, то оно укажет процент записи, которая должна находиться на уровне 0. Типичное значение 0.5, определяя половину записи для каждого уровня. Значение 0,0 или 1.0 не изменит точку перехода уровня 0.

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

    • kDRBurnFailureActionEject

      kDRBurnFailureActionEject

      Указание объекта CFString, что диск должен извлечь диск, если запись перестала работать.

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

    • kDRBurnFailureActionKey

      kDRBurnFailureActionKey

      Действие, чтобы брать отказ записи, со значением по умолчанию извлекаются.

      Этот ключ свойства записи соответствует объекту CFString, содержащему одно из доступных действий отказа для обработки содержимого диска.

      Если этот ключ не будет присутствовать, то запись примет значение по умолчанию к значению kDRBurnFailureActionEject, и диск будет извлечен.

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

    • kDRBurnFailureActionNone

      kDRBurnFailureActionNone

      Указание объекта CFString, что диск ничего не должен делать с диском, если запись перестала работать.

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

    • kDRBurnOverwriteDiscKey

      kDRBurnOverwriteDiscKey

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

      Этот ключ свойства записи соответствует объекту CFBoolean, содержащему флаг, указывающий, будет ли диск перезаписан от блочного нуля для записи. Если этот ключ не будет присутствовать, то запись примет значение по умолчанию к значению false и диск будет добавлен.

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

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

    • kDRBurnRequestedSpeedKey

      kDRBurnRequestedSpeedKey

      Требуемая скорость записи.

      Этот ключ свойства записи соответствует объекту CFNumber, содержащему скорость, на которой запись должна работать, выраженный как значение с плавающей точкой в килобайтах в секунду где 1 килобайт = 1 000 байтов. Если этот ключ не присутствует, требуемые максимальные значения по умолчанию скорости записи к kDRDeviceBurnSpeedMax.

      Скорость, на которой будет работать запись, зависит от нескольких факторов включая скорость шины, с которой диск подключен, способность скорости передачи данных, диск, длительный уровень, на котором данные могут быть произведены, и предел Ваши наборы приложения в ключах свойства дорожки kDRMaxBurnSpeedKey. Например, 16x диск соединился по результатам USB 1.0 в максимальной поддерживаемой пропускной способности к диску просто 2x вследствие ограничения пропускной способности шины.

      Некоторые более быстрые диски имеют минимальную скорость записи. В случае диска, минимальная скорость которого 4x, например, запрашивая 1x, запись приведет к фактической скорости записи 4x.

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

    • kDRBurnStatusChangedNotification

      kDRBurnStatusChangedNotification

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

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

    • kDRBurnStrategyBDDAO

      kDRBurnStrategyBDDAO

      Объект CFString представление диска сразу (DAO) записывает стратегию BD.

      Эта стратегия применяется только к BDs (Blu-ray).

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

    • kDRBurnStrategyCDSAO

      kDRBurnStrategyCDSAO

      Объект CFString представление сеанса сразу (SAO) записывает стратегию CD.

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

    • kDRBurnStrategyCDTAO

      kDRBurnStrategyCDTAO

      Объект CFString представление дорожки сразу (TAO) записывает стратегию CD.

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

    • kDRBurnStrategyDVDDAO

      kDRBurnStrategyDVDDAO

      Объект CFString представление диска сразу (DAO) записывает стратегию DVD.

      Эта стратегия применяется только к DVDs. Это не допустимо при записи к носителям CD.

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

    • kDRBurnStrategyIsRequiredKey

      kDRBurnStrategyIsRequiredKey

      Флаг, указывающий, попытаться ли осуществить указанные стратегии записи.

      Этот ключ свойства записи соответствует объекту CFBoolean указание, являются ли стратегия записи или стратегии, перечисленные для kDRBurnStrategyKey ключа, единственными позволенными. Если этот ключ не будет присутствовать, то запись будет вести себя, как будто ключ был false.

      Если значение этого ключа установлено в true и устройство не поддерживает ни одной из предложенных стратегий записи, запись перестанет работать с возвращаемым значением kDRDeviceBurnStrategyNotAvailableErr.

      Если значение этого ключа установлено в false и устройство не поддерживает ни одной из предложенных стратегий записи, механизм выберет альтернативную стратегию записи. Используемая стратегия записи обеспечит эквивалентный диск.

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

    • kDRBurnStrategyKey

      kDRBurnStrategyKey

      Один или более предложенные стратегии записи.

      Этот ключ свойства записи соответствует объекту CFString, или к объекту CFArray, содержащему объекты CFString, указывая предложенную стратегию записи или стратегии. Если этот ключ не присутствует, механизм записи выбирает надлежащую стратегию записи автоматически - таким образом, большинство клиентов не должно указывать стратегию записи.

      Когда больше чем одна стратегия предлагается, механизм записи пытается использовать первую стратегию в списке, который доступен. Стратегия записи никогда не будет использоваться, если она не может записать требуемые данные. Например, стратегия дорожки сразу (TAO) не может записать текст CD.

      Это присутствие одного только этого ключа является просто предложением - если механизм записи не может выполнить запрос, это запишет использование независимо от того, что стратегия доступна. Для преобразования предложения в требование добавьте kDRBurnStrategyIsRequiredKey ключ со значением true.

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

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

    • kDRBurnTestingKey

      kDRBurnTestingKey

      Флаг, указывающий, выполнить ли тест или нормальную запись.

      Этот ключ свойства записи соответствует объекту CFBoolean, содержащему флаг, указывающий, будет ли запись тестом или нет.

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

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

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

    • kDRBurnUnderrunProtectionKey

      kDRBurnUnderrunProtectionKey

      Флаг, указывающий, будет ли защита недогрузки записи идти или прочь.

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

      Защита недогрузки записи идет по умолчанию для дисков, поддерживающих ее. Клиенты действительно должны установить это значение кроме явно отключить защиту недогрузки.

      Если этот ключ не будет присутствовать, то запись примет значение по умолчанию к значению true и защита недогрузки записи будет, включил, если поддержка дисков это.

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

    • kDRBurnVerifyDiscKey

      kDRBurnVerifyDiscKey

      Флаг, указывающий, будет ли диск проверен после записи.

      Этот ключ свойства записи соответствует объекту CFBoolean, содержащему флаг, указывающий, будет ли диск проверен, будучи записанным. Если этот ключ не будет присутствовать, то запись примет значение по умолчанию к значению true и диск будет проверен.

      Проверка требует каждого объекта DRTrack указать, что его метод проверки посредством kDRVerificationTypeKey вводит словарь свойств дорожки. Если ни один из объектов DRTrack в записи не указал метод проверки, проверка не произойдет.

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

    • kDRCDTextKey

      kDRCDTextKey

      Этот ключ свойства записи соответствует объекту DRCDTextBlockRef, или к массиву объектов DRCDTextBlockRef, содержа информацию о тексте CD для диска. Если этот ключ не будет присутствовать, то запись не запишет текст CD.

      Перед использованием этого ключа необходимо гарантировать, что устройство поддерживает текст CD путем проверки, что значение kDRDeviceCanWriteCDTextKey вводит словарь возможностей записи устройства.

      Если это значение установлено в true и устройство не поддерживает текст CD записи, запись перестанет работать со значением kDRDeviceCantWriteCDTextErr.

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

    • kDRMediaCatalogNumberKey

      kDRMediaCatalogNumberKey

      Media Catalog Number (MCN) для записи в диск.

      Этот ключ свойства записи соответствует объекту CFData, содержащему точно 13 байтов данных, которые будут записаны в диск как Media Catalog Number (MCN). Если этот ключ не будет присутствовать, то он примет значение по умолчанию ко всем, обнуляет, указывая, что не предоставляется MCN.

      Это значение является стандартным номером продуктов UPC/EAN и должно соответствовать спецификациям UCC и EAN. Посмотрите http://www .ean-int.org и http://www .uc-council.org для получения дополнительной информации.

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

    • kDRSynchronousBehaviorKey

      kDRSynchronousBehaviorKey

      Флаг, указывающий, гореть ли синхронно или асинхронно.

      Этот ключ свойства записи соответствует объекту CFBoolean, содержащему флаг, указывающий, будут ли операции записи вести себя синхронно. Если этот ключ не будет присутствовать, то он примет значение по умолчанию к значению false и операции записи будут вести себя асинхронно.

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

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