Ссылка DRCoreBurn.h
Запишите интерфейсы объекта для Записи Диска.
Включенные заголовки
<CoreServices/CoreServices.h>
<DiscRecording/DRCoreObject.h>
<DiscRecording/DRCoreTrack.h>
<DiscRecording/DRCoreDevice.h>
<AvailabilityMacros.h>
-
Останавливает запись.
Параметры
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 и позже.
-
Создает новую запись.
Объявление
Objective C
DRBurnRef DRBurnCreate ( DRDeviceRef device );
Параметры
device
Ссылка на устройство для записи к. Если этот параметр не является допустимым DRDevice, поведение не определено.
Возвращаемое значение
Ссылка возвратов на новый экземпляр DRBurn.
Оператор импорта
Objective C
@import DiscRecording;
Swift
import DiscRecording
Доступность
Доступный в OS X v10.2 и позже.
-
Получает ссылку на устройство, связанное с записью.
Объявление
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.
Возвращаемое значение
Базовый идентификатор типа Основы.
Оператор импорта
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 и позже.
-
Пишет указанное расположение дорожек в диск.
Объявление
Параметры
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 выше для документации уровня заголовка.
-
Обсуждение
Ссылка на экземпляры 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 и позже.
-