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

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

Разработчик

Ссылка DRCoreTrack.h

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

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

Ссылка DRCoreTrack.h

Отслеживаемый объект взаимодействует через интерфейс для Записи Диска.

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

  • <CoreServices/CoreServices.h>

  • <DiscRecording/DRCoreDevice.h>

  • <DiscRecording/DRCoreObject.h>

  • <AvailabilityMacros.h>

Функции

  • Создает новый отслеживаемый объект.

    Объявление

    Swift

    func DRTrackCreate(_ properties: CFDictionary!, _ callback: DRTrackCallbackProc) -> Unmanaged<DRTrack>!

    Objective C

    DRTrackRef DRTrackCreate ( CFDictionaryRef properties, DRTrackCallbackProc callback );

    Параметры

    properties

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

    callback

    Указатель на обратный вызов DRTrackCallbackProc. Если этим обратным вызовом является NULL, поведение не определено.

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

    Ссылка на новый объект DRTrack.

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

  • Просит производитель дорожки оценку размера блока.

    Объявление

    Swift

    func DRTrackEstimateLength(_ track: DRTrack!) -> UInt64

    Objective C

    UInt64 DRTrackEstimateLength ( DRTrackRef track );

    Параметры

    track

    Дорожка для запросов.

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

    Размер дорожки в блоках.

    Обсуждение

    Это вызовы функции производитель дорожки, чтобы попросить, чтобы он оценил размер блока, необходимый для его данных. Через этот вызов проходят к производственному обратному вызову дорожки DRTrackCallbackProc как kDRTrackMessageEstimateLength.

    Для некоторых типов дорожек этот вызов может быть очень дорогим. Например, дорожка файловой системы (DRFilesystemTrack), возможно, должна выполнить итерации через папки на диске для обеспечения точной оценки. Если большое количество файлов и папок включается, этот вызов может занять 30 секунд или больше. Так как Ваш основной поток не должен блокировать для этого долго, можно хотеть вызвать эту функцию на отдельном потоке.

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

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

  • Возвращает свойства дорожки.

    Объявление

    Swift

    func DRTrackGetProperties(_ track: DRTrack!) -> Unmanaged<CFDictionary>!

    Objective C

    CFDictionaryRef DRTrackGetProperties ( DRTrackRef track );

    Параметры

    track

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

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

    Объект CFMutableDictionary, содержащий свойства дорожки.

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

  • Возвращает Базовый идентификатор типа Основы всех экземпляров DRTrack.

    Объявление

    Swift

    func DRTrackGetTypeID() -> CFTypeID

    Objective C

    CFTypeID DRTrackGetTypeID ( void );

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

  • Устанавливает свойства дорожки.

    Объявление

    Swift

    func DRTrackSetProperties(_ track: DRTrack!, _ properties: CFDictionary!)

    Objective C

    void DRTrackSetProperties ( DRTrackRef track, CFDictionaryRef properties );

    Параметры

    track

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

    properties

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

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

  • Тестирует скорость, на которой могут быть произведены данные.

    Объявление

    Swift

    func DRTrackSpeedTest(_ track: DRTrack!, _ howManyMilliseconds: UInt32, _ howManyBytes: UInt32) -> Float

    Objective C

    float DRTrackSpeedTest ( DRTrackRef track, UInt32 howManyMilliseconds, UInt32 howManyBytes );

    Параметры

    track

    Дорожка для тестирования.

    howManyMilliseconds

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

    howManyBytes

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

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

    Максимальная пропускная способность получена во время тестового цикла.

    Обсуждение

    Выполняет производственный цикл испытательной площадки, вызывая produceData обратный вызов для конкретного количества миллисекунд или пока конкретное количество байтов не было произведено, какой бы ни на первом месте.

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

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

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

Обратные вызовы

  • Обратный вызов, определенный в клиенте для создания данных дорожки для записи.

    Объявление

    Swift

    typealias DRTrackCallbackProc = CFunctionPointer<((DRTrack!, DRTrackMessage, UnsafeMutablePointer<Void>) -> OSStatus)>

    Objective C

    typedef OSStatus ( *DRTrackCallbackProc)( DRTrackRef track, DRTrackMessage message, void *ioParam);

    Параметры

    track

    Дорожка с этим обратным вызовом связана.

    message

    Указывает тип данных, запрошенных как одна из констант в перечислении сообщений Дорожки.

    ioParam

    Параметры специфичны для сообщения.

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

    Код ошибки. Ваше клиентское приложение должно возвратить значение kDRFunctionNotSupportedErr, когда сообщение получено, что Вы не отвечаете на, и значение noErr, когда сообщение обрабатывается успешно. Любая другая ошибка заставит запись сразу перестать работать со значением, которое Вы возвращаете как код ошибки.

    Обсуждение

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

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

Типы данных

См. Обзор для документации уровня заголовка.

  • Сообщения отправили к обратному вызову DRTrackCallbackProc.

    Объявление

    Swift

    typealias DRTrackMessage = UInt32

    Objective C

    typedef UInt32 DRTrackMessage;

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

  • Объявление

    Swift

    typealias DRTrackRef = DRTrack

    Objective C

    typedef struct __DRTrack* DRTrackRef;

    Обсуждение

    Ссылка на объект DRTrack.

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

    Objective C

    @import DiscRecording;

    Swift

    import DiscRecording

    Доступность

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

  • Блок Parmeter используется для производства данных.

    Объявление

    Objective C

    struct DRTrackProductionInfo { void *buffer; UInt32 reqCount; UInt32 actCount; UInt32 flags; UInt32 blockSize; UInt64 requestedAddress; };

    Поля

    buffer

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

    reqCount

    В - число байтов требует механизм.

    actCount

    - число байтов, фактически произведенных (между 0 и reqCount).

    flags

    InOut - Разные флаги. Флаги передаются в производственный обратный вызов обратного вызова дорожки от механизма Записи Диска, и обратный вызов может установить флаги, которые будут пасоваться назад к механизму.

    blockSize

    В - размер блока механизм ожидает. Для лучших результатов возвратите сеть магазинов этого размера.

    requestedAddress

    В - адрес байта, который механизм записи запрашивает от объекта (на основе 0). Это постепенно увеличивается при отправке данных как можно было бы ожидать.

Константы

См. Обзор для документации уровня заголовка.

  • Объявление

    Swift

    let kDRAudioFourChannelKey: CFString! let kDRAudioPreEmphasisKey: CFString! let kDRBlockSizeKey: CFString! let kDRBlockTypeKey: CFString! let kDRBufferZone1DataKey: CFString! let kDRBurnKey: CFString! let kDRDataFormKey: CFString! let kDRDVDCopyrightInfoKey: CFString! let kDRDVDTimestampKey: CFString! let kDRFreeBlocksKey: CFString! let kDRIndexPointsKey: CFString! let kDRMaxBurnSpeedKey: CFString! let kDRNextWritableAddressKey: CFString! let kDRPreGapIsRequiredKey: CFString! let kDRPreGapLengthKey: CFString! let kDRSCMSCopyrightFree: CFString! let kDRSCMSCopyrightProtectedCopy: CFString! let kDRSCMSCopyrightProtectedOriginal: CFString! let kDRSerialCopyManagementStateKey: CFString! let kDRSessionFormatKey: CFString! let kDRSessionNumberKey: CFString! let kDRSubchannelDataFormKey: CFString! let kDRSubchannelDataFormNone: CFString! let kDRSubchannelDataFormPack: CFString! let kDRSubchannelDataFormRaw: CFString! let kDRTrackIsEmptyKey: CFString! let kDRTrackISRCKey: CFString! let kDRTrackLengthKey: CFString! let kDRTrackModeKey: CFString! let kDRTrackNumberKey: CFString! let kDRTrackPacketSizeKey: CFString! let kDRTrackPacketTypeFixed: CFString! let kDRTrackPacketTypeKey: CFString! let kDRTrackPacketTypeVariable: CFString! let kDRTrackStartAddressKey: CFString! let kDRTrackTypeClosed: CFString! let kDRTrackTypeIncomplete: CFString! let kDRTrackTypeInvisible: CFString! let kDRTrackTypeKey: CFString! let kDRTrackTypeReserved: CFString! let kDRVerificationTypeChecksum: CFString! let kDRVerificationTypeKey: CFString! let kDRVerificationTypeNone: CFString! let kDRVerificationTypeProduceAgain: CFString! let kDRVerificationTypeReceiveData: CFString!

    Objective C

    extern const CFStringRef kDRAudioFourChannelKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRAudioPreEmphasisKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRBlockSizeKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER; extern const CFStringRef kDRBlockTypeKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER; extern const CFStringRef kDRBufferZone1DataKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER; extern const CFStringRef kDRBurnKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER; extern const CFStringRef kDRDataFormKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER; extern const CFStringRef kDRDVDCopyrightInfoKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER; extern const CFStringRef kDRDVDTimestampKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER; extern const CFStringRef kDRFreeBlocksKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRIndexPointsKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRMaxBurnSpeedKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER; extern const CFStringRef kDRNextWritableAddressKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRPreGapIsRequiredKeyAVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER; extern const CFStringRef kDRPreGapLengthKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER; extern const CFStringRef kDRSCMSCopyrightFreeAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRSCMSCopyrightProtectedCopyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRSCMSCopyrightProtectedOriginalAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRSerialCopyManagementStateKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRSessionFormatKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER; extern const CFStringRef kDRSessionNumberKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRSubchannelDataFormKeyAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER; extern const CFStringRef kDRSubchannelDataFormNoneAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER; extern const CFStringRef kDRSubchannelDataFormPackAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER; extern const CFStringRef kDRSubchannelDataFormRawAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER; extern const CFStringRef kDRTrackIsEmptyKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRTrackISRCKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRTrackLengthKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER; extern const CFStringRef kDRTrackModeKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER; extern const CFStringRef kDRTrackNumberKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRTrackPacketSizeKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRTrackPacketTypeFixedAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRTrackPacketTypeKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRTrackPacketTypeVariableAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRTrackStartAddressKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRTrackTypeClosedAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRTrackTypeIncompleteAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRTrackTypeInvisibleAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRTrackTypeKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRTrackTypeReservedAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER; extern const CFStringRef kDRVerificationTypeChecksumAVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER; extern const CFStringRef kDRVerificationTypeKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER; extern const CFStringRef kDRVerificationTypeNoneAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER; extern const CFStringRef kDRVerificationTypeProduceAgainAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER; extern const CFStringRef kDRVerificationTypeReceiveDataAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;

    Константы

    • kDRAudioFourChannelKey

      kDRAudioFourChannelKey

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

      Аудио с четырьмя каналами поддерживается в стандарте Красной книги, но никогда не завоевывало популярность. Это, вероятно, заменяется SACD, таким образом, Вы, вероятно, не должны пытаться использовать его.

      На диске этот ключ соответствует биту 3 из поля элемента управления в подканале Q.

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

    • kDRAudioPreEmphasisKey

      kDRAudioPreEmphasisKey

      Дополнительный ключ. Для аудиотреков CD-DA только. Этот ключ свойства дорожки соответствует значению CFBoolean, указывающему, включает ли дорожка предварительный акцент 50/15 микросекунд. Если этот ключ не будет присутствовать, то механизм будет использовать значение по умолчанию false. На диске этот ключ соответствует биту 0 из поля элемента управления в подканале Q.

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

    • kDRBlockSizeKey

      kDRBlockSizeKey

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

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

    • kDRBlockTypeKey

      kDRBlockTypeKey

      Требуемый ключ. Этот ключ соответствует объекту CFNumber, содержащему тип каждого блока дорожки. Общие ценности определяются в Блочном перечислении.

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

    • kDRBufferZone1DataKey

      kDRBufferZone1DataKey

      Дополнительный ключ. Этот ключ свойства дорожки соответствует объекту CFData, содержащему данные для записи в Буферную зону 1 на дисках, поддерживающих его, такие как DVR-S201 Pioneer. Эти данные будут отправлены непосредственно в диск. Если этот ключ не будет присутствовать, никакая Буферная зона, то 1 данные будут отправлены.

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

    • kDRBurnKey

      kDRBurnKey

      Этот ключ соответствует объекту DRBurn, для которого применяется сообщение PreBurn.

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

    • kDRDataFormKey

      kDRDataFormKey

      Требуемый ключ. Этот ключ соответствует объекту CFNumber, содержащему формат данных каждого блока дорожки. Общие ценности определяются в перечислении Форм Данных.

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

    • kDRDVDCopyrightInfoKey

      kDRDVDCopyrightInfoKey

      Дополнительный ключ. Этот ключ свойства дорожки соответствует объекту CFData, содержащему данные авторского права Multi-Media Command (MMC). Эти данные будут отправлены непосредственно в диск. Если этот ключ не будет присутствовать, то никакая информация об авторском праве не будет отправлена.

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

    • kDRDVDTimestampKey

      kDRDVDTimestampKey

      Дополнительный ключ. Этот ключ свойства дорожки соответствует объекту CFData, содержащему данные метки времени Multi-Media Command (MMC). Эти данные будут отправлены непосредственно в диск. Если этот ключ не будет присутствовать, то никакая метка времени не будет отправлена.

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

    • kDRFreeBlocksKey

      kDRFreeBlocksKey

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

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

    • kDRIndexPointsKey

      kDRIndexPointsKey

      Дополнительный ключ. Поскольку CD отслеживает только. Этот ключ свойства дорожки соответствует объекту CFArray, содержащему объекты CFNumber, описывающие индексные точки в дорожке. Каждая индексная точка указана как много блоков, эквивалентных кадрам, относительно запуска дорожки. Существует 75 блоков за одну секунду аудио CD. Не больше, чем 98 индексных точек могут быть указаны для дорожки.

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

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

    • kDRMaxBurnSpeedKey

      kDRMaxBurnSpeedKey

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

      Значение для kDRMaxBurnSpeedKey должно быть больше, чем минимальная скорость записи диска. Обычно безопасно указать надлежащую разновидность 1x (kDRDeviceBurnSpeedCD1x или kDRDeviceBurnSpeedDVD1x), но некоторые диски не могут замедлиться полностью вниз к 1x.

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

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

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

    • kDRNextWritableAddressKey

      kDRNextWritableAddressKey

      Этот ключ соответствует объекту CFNumber, содержащему Logical Block Address (LBA) следующего перезаписываемого адреса в дорожке. Этот ключ не присутствует в закрытых дорожках.

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

    • kDRPreGapIsRequiredKey

      kDRPreGapIsRequiredKey

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

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

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

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

    • kDRPreGapLengthKey

      kDRPreGapLengthKey

      Дополнительный ключ. Этот ключ свойства дорожки соответствует объекту CFNumber, содержащему длину в блоках вакуума или предварительный разрыв, чтобы быть зарегистрированным перед дорожкой. Если этот ключ не будет присутствовать, то механизм Записи Диска примет 2-секундное, или 150 блоков, предварительный разрыв.

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

    • kDRSCMSCopyrightFree

      kDRSCMSCopyrightFree

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

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

    • kDRSCMSCopyrightProtectedCopy

      kDRSCMSCopyrightProtectedCopy

      Одно значение для kDRSerialCopyManagementStateKey ключа словаря. Это значение указывает, что дорожка является копией первого поколения оригинала, подвергавшегося защите от копирования. Никакое дальнейшее цифровое копирование не должно быть позволено.

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

    • kDRSCMSCopyrightProtectedOriginal

      kDRSCMSCopyrightProtectedOriginal

      Одно значение для kDRSerialCopyManagementStateKey ключа словаря. Это значение указывает, что дорожка является исходным предметом к защите авторских прав. Цифровое копирование этой дорожки должно быть позволено, но копии должны быть отмечены с надлежащими данными Системы управления последовательным копированием (SCMS).

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

    • kDRSerialCopyManagementStateKey

      kDRSerialCopyManagementStateKey

      Дополнительный ключ. Поскольку CD отслеживает только. Этот ключ свойства дорожки соответствует значению CFString, указывающему состояние Системы управления последовательным копированием (SCMS) дорожки. Если этот ключ не присутствует, никакие данные SCMS не записаны.

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

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

    • kDRSessionFormatKey

      kDRSessionFormatKey

      Требуемый ключ. Этот ключ соответствует объекту CFNumber, содержащему формат сеанса дорожки. Общие ценности определяются в перечислении Режима Сеанса.

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

    • kDRSessionNumberKey

      kDRSessionNumberKey

      Этот ключ соответствует объекту CFNumber, содержащему физическое число сеанса дорожки.

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

    • kDRSubchannelDataFormKey

      kDRSubchannelDataFormKey

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

      Данные подканала возвращаются от производителя в том же методе производства, производящем данные обычного пользователя. Обычно производитель возвращает пользовательские данные в блоках размера DRBlockSizeKey. Когда данные подканала будут также произведены, производитель, как ожидают, возвратит пользовательские данные DRBlockSizeKey в длине с дополнительными 96 байтами данных подканала. В зависимости от формы данных, указанной в этом ключе, формат этого 96 байтов или в сырых данных или в формате пакета. Когда данные подканала запрашиваются от производителя, флаг DRFlagSubchannelDataRequested установлен в параметре флагов producePreGapForTrack:intoBuffer:length:atAddress:blockSize:ioFlags: или produceDataForTrack:intoBuffer:length:atAddress:blockSize:ioFlags: и blockSize увеличен на 96 байтов.

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

    • kDRSubchannelDataFormNone

      kDRSubchannelDataFormNone

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

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

    • kDRSubchannelDataFormPack

      kDRSubchannelDataFormPack

      Значение для DRSubchannelDataFormKey, указывающего, что производителя попросят предоставить данные подканала формата пакета для дорожки. Если эта форма будет выбрана, то диск выполнит P и вычисления блоков четности Q на каждом пакете и чередует пакеты прежде, чем записать им в диск. Это соответствует форме данных подканала 0xC0.

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

    • kDRSubchannelDataFormRaw

      kDRSubchannelDataFormRaw

      Значение для DRSubchannelDataFormKey, указывающего, что производителя попросят предоставить данные подканала необработанного формата для дорожки. Если эта форма выбрана, производитель, должно быть, выполнил P и вычисления блоков четности Q для каждого пакета и сделал надлежащее чередование данных подканала. Диск заполнит информацию о подканале P-Q и запишет данные подканала R-W, как к диску. Это соответствует форме данных подканала 0x40.

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

    • kDRTrackIsEmptyKey

      kDRTrackIsEmptyKey

      Этот ключ соответствует объекту CFBoolean и указывает, пуста ли дорожка.

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

    • kDRTrackISRCKey

      kDRTrackISRCKey

      Дополнительный ключ. Для аудиотреков CD-DA только. Этот ключ свойства дорожки соответствует объекту CFData, содержащему точно 12 байтов, которые будут записаны в диск как Код записи по международному стандарту (ISRC). Если этот ключ не присутствует, никакие данные ISRC не записаны.

      Использование этого значения должно соответствовать спецификациям IFPI. Посмотрите http://www .ifpi.org/isrc для подробных данных о стандарте ISRC.

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

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

    • kDRTrackLengthKey

      kDRTrackLengthKey

      Требуемый Ключ. Этот ключ соответствует объекту CFNumber, содержащему длину данных дорожки в блоках.

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

    • kDRTrackModeKey

      kDRTrackModeKey

      Требуемый ключ. Этот ключ соответствует объекту CFNumber, содержащему режим дорожки дорожки. Общие ценности определяются в перечислении Режимов Дорожки.

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

    • kDRTrackNumberKey

      kDRTrackNumberKey

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

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

    • kDRTrackPacketSizeKey

      kDRTrackPacketSizeKey

      Этот ключ соответствует объекту CFNumber, содержащему число блоков на пакет для диска. Если диск будет содержать фиксированные пакеты, это будет только присутствовать. Этот ключ будет содержать '16' для носителей DVD, и обычно содержит или '16' или '32' для носителей CD.

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

    • kDRTrackPacketTypeFixed

      kDRTrackPacketTypeFixed

      Одно значение для kDRTrackPacketTypeKey ключа словаря. Это значение указывает, что диск записан с фиксированными размерными пакетами. Когда это значение будет присутствовать, kDRPacketSizeKey ключ словаря будет также присутствовать.

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

    • kDRTrackPacketTypeKey

      kDRTrackPacketTypeKey

      Этот ключ соответствует значению CFString, указывающему вид записанных пакетов.

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

    • kDRTrackPacketTypeVariable

      kDRTrackPacketTypeVariable

      Одно значение для kDRTrackPacketTypeKey ключа словаря. Это значение указывает, что диск записан с последовательными, пакетами переменного размера. Когда этот ключ будет присутствовать, kDRPacketSizeKey ключ словаря не будет.

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

    • kDRTrackStartAddressKey

      kDRTrackStartAddressKey

      Этот ключ соответствует объекту CFNumber, содержащему Logical Block Address (LBA) начального адреса для дорожки.

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

    • kDRTrackTypeClosed

      kDRTrackTypeClosed

      Одно значение для kDRTrackTypeKey ключа словаря. Это значение указывает, что дорожка была записана и закрывается.

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

    • kDRTrackTypeIncomplete

      kDRTrackTypeIncomplete

      Одно значение для kDRTrackTypeKey ключа словаря. Это значение указывает, что дорожка весьма видима или зарезервирована и доступна для записи.

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

    • kDRTrackTypeInvisible

      kDRTrackTypeInvisible

      Одно значение для kDRTrackTypeKey ключа словаря. Это значение указывает, что дорожка невидима и доступна для записи. Если это будет записанный пакет и не закрытое, то kDRTrackPacketType ключ будет присутствовать вместе с kDRTrackPacketSize ключами.

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

    • kDRTrackTypeKey

      kDRTrackTypeKey

      Этот ключ соответствует объекту CFString указание типа дорожки. Возможные значения являются kDRTrackTypeInvisible, kDRTrackTypeIncomplete, kDRTrackTypeReserved, или kDRTrackTypeClosed.

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

    • kDRTrackTypeReserved

      kDRTrackTypeReserved

      Одно значение для kDRTrackTypeKey ключа словаря. Это значение указывает, что дорожка резервируется для записи.

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

    • kDRVerificationTypeChecksum

      kDRVerificationTypeChecksum

      Одно значение для kDRVerificationTypeKey ключа словаря. Это значение указывает, что механизм проверит данные дорожки с внутренне расчетной контрольной суммой.

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

    • kDRVerificationTypeKey

      kDRVerificationTypeKey

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

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

    • kDRVerificationTypeNone

      kDRVerificationTypeNone

      Одно значение для kDRVerificationTypeKey ключа словаря. Это значение указывает, что механизм не сделает никакого вида проверки на данных дорожки.

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

    • kDRVerificationTypeProduceAgain

      kDRVerificationTypeProduceAgain

      Одно значение для kDRVerificationTypeKey ключа словаря. Это значение указывает, что механизм запустит другой производственный цикл, и клиент просто производит данные снова из запуска.

      Обратите внимание на то, что этот режим проверки в настоящее время только работает с данными CDs и DVDs.

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

    • kDRVerificationTypeReceiveData

      kDRVerificationTypeReceiveData

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

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

  • Объявление

    Swift

    var kDRBlockSizeAudio: Int { get } var kDRBlockSizeMode1Data: Int { get } var kDRBlockSizeMode2Data: Int { get } var kDRBlockSizeMode2Form1Data: Int { get } var kDRBlockSizeMode2Form2Data: Int { get } var kDRBlockSizeDVDData: Int { get }

    Objective C

    enum { kDRBlockSizeAudio = 2352, kDRBlockSizeMode1Data = 2048, kDRBlockSizeMode2Data = 2332, kDRBlockSizeMode2Form1Data = 2048, kDRBlockSizeMode2Form2Data = 2324, kDRBlockSizeDVDData = 2048 };

    Константы

    • kDRBlockSizeAudio

      kDRBlockSizeAudio

      Аудиоданные.

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

    • kDRBlockSizeMode1Data

      kDRBlockSizeMode1Data

      Режим 1 данные.

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

    • kDRBlockSizeMode2Data

      kDRBlockSizeMode2Data

      Режим 2 данных. Фотография CD и CD-i использует это.

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

    • kDRBlockSizeMode2Form1Data

      kDRBlockSizeMode2Form1Data

      Режим 2 Формы 1 данные.

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

    • kDRBlockSizeMode2Form2Data

      kDRBlockSizeMode2Form2Data

      Режим 2 Формы 2 данных.

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

    • kDRBlockSizeDVDData

      kDRBlockSizeDVDData

      Данные DVD.

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

    Обсуждение

    Общие размеры блока для различных типов данных дорожки.

  • Объявление

    Swift

    var kDRBlockTypeAudio: Int { get } var kDRBlockTypeMode1Data: Int { get } var kDRBlockTypeMode2Data: Int { get } var kDRBlockTypeMode2Form1Data: Int { get } var kDRBlockTypeMode2Form2Data: Int { get } var kDRBlockTypeDVDData: Int { get }

    Objective C

    enum { kDRBlockTypeAudio = 0, kDRBlockTypeMode1Data = 8, kDRBlockTypeMode2Data = 13, kDRBlockTypeMode2Form1Data = 10, kDRBlockTypeMode2Form2Data = 12, kDRBlockTypeDVDData = 8 };

    Константы

    • kDRBlockTypeAudio

      kDRBlockTypeAudio

      Аудиоданные.

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

    • kDRBlockTypeMode1Data

      kDRBlockTypeMode1Data

      Режим 1 данные.

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

    • kDRBlockTypeMode2Data

      kDRBlockTypeMode2Data

      Режим 2 данных. Фотография CD и CD-i использует это.

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

    • kDRBlockTypeMode2Form1Data

      kDRBlockTypeMode2Form1Data

      Режим 2 Формы 1 данные.

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

    • kDRBlockTypeMode2Form2Data

      kDRBlockTypeMode2Form2Data

      Режим 2 Формы 2 данных.

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

    • kDRBlockTypeDVDData

      kDRBlockTypeDVDData

      Данные DVD.

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

    Обсуждение

    Общий тип блока оценивает за типы данных дорожки.

  • Объявление

    Swift

    var kDRDataFormAudio: Int { get } var kDRDataFormMode1Data: Int { get } var kDRDataFormMode2Data: Int { get } var kDRDataFormMode2Form1Data: Int { get } var kDRDataFormMode2Form2Data: Int { get } var kDRDataFormDVDData: Int { get }

    Objective C

    enum { kDRDataFormAudio = 0, kDRDataFormMode1Data = 16, kDRDataFormMode2Data = 32, kDRDataFormMode2Form1Data = 32, kDRDataFormMode2Form2Data = 32, kDRDataFormDVDData = 16 };

    Константы

    • kDRDataFormAudio

      kDRDataFormAudio

      Аудиоданные.

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

    • kDRDataFormMode1Data

      kDRDataFormMode1Data

      Режим 1 данные.

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

    • kDRDataFormMode2Data

      kDRDataFormMode2Data

      Режим 2 данных. Фотография CD и CD-i использует это.

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

    • kDRDataFormMode2Form1Data

      kDRDataFormMode2Form1Data

      Режим 2 Формы 1 данные.

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

    • kDRDataFormMode2Form2Data

      kDRDataFormMode2Form2Data

      Режим 2 Формы 2 данных.

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

    • kDRDataFormDVDData

      kDRDataFormDVDData

      Данные DVD.

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

    Обсуждение

    Общие данные формируют значения для типов данных дорожки.

  • Объявление

    Swift

    var kDRSessionFormatAudio: Int { get } var kDRSessionFormatMode1Data: Int { get } var kDRSessionFormatCDI: Int { get } var kDRSessionFormatCDXA: Int { get } var kDRSessionFormatDVDData: Int { get }

    Objective C

    enum { kDRSessionFormatAudio = 0, kDRSessionFormatMode1Data = 0, kDRSessionFormatCDI = 0x10, kDRSessionFormatCDXA = 0x20, kDRSessionFormatDVDData = 0 };

    Константы

    • kDRSessionFormatAudio

      kDRSessionFormatAudio

      Аудиоданные.

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

    • kDRSessionFormatMode1Data

      kDRSessionFormatMode1Data

      Режим 1 данные.

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

    • kDRSessionFormatCDI

      kDRSessionFormatCDI

      Диск CD-I.

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

    • kDRSessionFormatCDXA

      kDRSessionFormatCDXA

      CDROM диск XA.

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

    • kDRSessionFormatDVDData

      kDRSessionFormatDVDData

      Данные DVD.

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

    Обсуждение

    Общий формат сеанса оценивает за типы данных дорожки.

  • Объявление

    Swift

    var kDRFlagNoMoreData: Int { get } var kDRFlagSubchannelDataRequested: Int { get }

    Objective C

    enum { #if MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_5 kDRFlagSubchannelDataRequested = ( 1 << 1), #endif kDRFlagNoMoreData = ( 1 << 0) };

    Константы

    • kDRFlagNoMoreData

      kDRFlagNoMoreData

      Указывает конец данных переменной длины.

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

    • kDRFlagSubchannelDataRequested

      kDRFlagSubchannelDataRequested

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

      [пользовательские данные (как указано в свойствах дорожки)] [данные подканала (96 байтов)].

      Например, аудио обратный вызов производителя должен произвести 2 352 байта аудиоданных в байты 0-2351 из блока и дополнительные 96 байтов данных подканала в байты 2352-2447.

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

    Обсуждение

    Эти флаги являются опциями в структуре DRTrackProductionInfo.

  • Объявление

    Swift

    var kDRTrackMessagePreBurn: Int { get } var kDRTrackMessageProduceData: Int { get } var kDRTrackMessageVerificationStarting: Int { get } var kDRTrackMessageVerifyData: Int { get } var kDRTrackMessageVerificationDone: Int { get } var kDRTrackMessagePostBurn: Int { get } var kDRTrackMessageEstimateLength: Int { get } var kDRTrackMessageProducePreGap: Int { get } var kDRTrackMessageVerifyPreGap: Int { get }

    Objective C

    enum { kDRTrackMessagePreBurn = 'pre ', kDRTrackMessageProduceData = 'prod', kDRTrackMessageVerificationStarting = 'vstr', kDRTrackMessageVerifyData = 'vrfy', kDRTrackMessageVerificationDone = 'vdon', kDRTrackMessagePostBurn = 'post', kDRTrackMessageEstimateLength = 'esti', /* added in 10.3 */ kDRTrackMessageProducePreGap = 'prpr', /* added in 10.3 */ kDRTrackMessageVerifyPreGap = 'vrpr' /* added in 10.4 */ };

    Константы

    • kDRTrackMessagePreBurn

      kDRTrackMessagePreBurn

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

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

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

    • kDRTrackMessageProduceData

      kDRTrackMessageProduceData

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

      ioParam параметр является указателем на структуру DRTrackProductionInfo.

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

    • kDRTrackMessageVerificationStarting

      kDRTrackMessageVerificationStarting

      Сообщение отправило в обратный вызов proc указание, что проверка собирается начаться.

      ioParam не используется и является NULL.

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

    • kDRTrackMessageVerifyData

      kDRTrackMessageVerifyData

      Когда клиент выбрал kDRVerificationTypeReceiveData опцию, сообщение отправило к производственному обратному вызову дорожки.

      ioParam параметр является указателем на структуру DRTrackProductionInfo, описывающую данные, переданные обратному вызову.

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

    • kDRTrackMessageVerificationDone

      kDRTrackMessageVerificationDone

      Когда проверка завершена, сообщение отправило к производственному обратному вызову дорожки.

      ioParam параметр не используется и является NULL.

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

    • kDRTrackMessagePostBurn

      kDRTrackMessagePostBurn

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

      ioParam параметр не используется и является NULL.

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

    • kDRTrackMessageEstimateLength

      kDRTrackMessageEstimateLength

      Сообщение отправило к производственному обратному вызову дорожки, просящему, чтобы он оценил длину дорожки. Когда функция DRTrackEstimateLength вызвана, это сообщение отправляется за пределами цикла записи.

      ioParam параметр является указателем на значение UInt64, которое обратный вызов заполняет с предполагаемым числом блоков для дорожки. Оценка должна быть довольно точной и не меньшей, чем фактический размер, который будет необходим.

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

    • kDRTrackMessageProducePreGap

      kDRTrackMessageProducePreGap

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

      ioParam параметр является указателем на структуру DRTrackProductionInfo.

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

    • kDRTrackMessageVerifyPreGap

      kDRTrackMessageVerifyPreGap

      Когда клиент выбрал kDRVerificationTypeReceiveData опцию, сообщение отправило к производственному обратному вызову дорожки. Данные, произведенные клиентом для kDRTrackMessageProducePreGap, должны быть проверены.

      ioParam параметр является указателем на структуру DRTrackProductionInfo, описывающую данные, переданные обратному вызову.

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

    Обсуждение

    Сообщения отправили к обратному вызову DRTrackCallbackProc во время записи.

  • Объявление

    Swift

    var kDRTrackModeAudio: Int { get } var kDRTrackMode1Data: Int { get } var kDRTrackMode2Data: Int { get } var kDRTrackMode2Form1Data: Int { get } var kDRTrackMode2Form2Data: Int { get } var kDRTrackModeDVDData: Int { get }

    Objective C

    enum { kDRTrackModeAudio = 0, kDRTrackMode1Data = 4, kDRTrackMode2Data = 4, kDRTrackMode2Form1Data = 4, kDRTrackMode2Form2Data = 4, kDRTrackModeDVDData = 5 };

    Константы

    • kDRTrackModeAudio

      kDRTrackModeAudio

      Аудиоданные.

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

    • kDRTrackMode1Data

      kDRTrackMode1Data

      Режим 1 данные.

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

    • kDRTrackMode2Data

      kDRTrackMode2Data

      Режим 2 данных. Фотография CD и CD-i использует это.

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

    • kDRTrackMode2Form1Data

      kDRTrackMode2Form1Data

      Режим 2 Формы 1 данные.

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

    • kDRTrackMode2Form2Data

      kDRTrackMode2Form2Data

      Режим 2 Формы 2 данных.

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

    • kDRTrackModeDVDData

      kDRTrackModeDVDData

      Данные DVD.

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

    Обсуждение

    Общий режим дорожки оценивает за типы данных дорожки.