Ссылка DRCoreErrors.h

Диск, Записывающий коды ошибки и описания.

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

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

<CoreServices/CoreServices.h>
<AvailabilityMacros.h>

Функции

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


    
    DRCopyLocalizedStringForAdditionalSense (_: _:)
    DRCopyLocalizedStringForAdditionalSense

Отображает Additional Sense Code (ASC) и Дополнительный Ключевой Спецификатор Смысла (ASCQ) к локализованной строке.

Объявление

Swift

func DRCopyLocalizedStringForAdditionalSense(_ ASC: UInt8, _ ASCQ: UInt8) -> Unmanaged<CFString>!

Objective C

CFStringRef DRCopyLocalizedStringForAdditionalSense ( UInt8 ASC, UInt8 ASCQ );

Параметры

`ASC`	Дополнительный Код Смысла, сгенерированный устройством, приспосабливающим стандарту SCSI.
`ASCQ`	Дополнительный Спецификатор Кода Смысла, сгенерированный устройством, соответствующим стандарту SCSI.

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

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

Обсуждение

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

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

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

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

DRCopyLocalizedStringForDiscRecordingError (_:) DRCopyLocalizedStringForDiscRecordingError

Отображает код ошибки операционной системы на локализованную строку.

Объявление

Swift

func DRCopyLocalizedStringForDiscRecordingError(_ osError: OSStatus) -> Unmanaged<CFString>!

Objective C

CFStringRef DRCopyLocalizedStringForDiscRecordingError ( OSStatus osError );

Параметры

osError

Код ошибки OS.

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

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

Обсуждение

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

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

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

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


    
    DRCopyLocalizedStringForSenseCode (_:)
    DRCopyLocalizedStringForSenseCode

Отображает код смысла SCSI на локализованную строку.

Объявление

Swift

func DRCopyLocalizedStringForSenseCode(_ senseCode: UInt8) -> Unmanaged<CFString>!

Objective C

CFStringRef DRCopyLocalizedStringForSenseCode ( UInt8 senseCode );

Параметры


      senseCode

Код смысла, сгенерированный устройством, соответствующим стандарту SCSI.

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

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

Обсуждение

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

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

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

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

Константы

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

Глобальные константы
Объявление

Swift

let kDRErrorStatusAdditionalSenseStringKey: CFString! let kDRErrorStatusErrorInfoStringKey: CFString! let kDRErrorStatusErrorKey: CFString! let kDRErrorStatusErrorStringKey: CFString! let kDRErrorStatusKey: CFString! let kDRErrorStatusSenseCodeStringKey: CFString! let kDRErrorStatusSenseKey: CFString!

Objective C

extern const CFStringRef kDRErrorStatusAdditionalSenseStringKey; extern const CFStringRef kDRErrorStatusErrorInfoStringKey; extern const CFStringRef kDRErrorStatusErrorKey; extern const CFStringRef kDRErrorStatusErrorStringKey; extern const CFStringRef kDRErrorStatusKey; extern const CFStringRef kDRErrorStatusSenseCodeStringKey; extern const CFStringRef kDRErrorStatusSenseKey;

Константы
- kDRErrorStatusAdditionalSenseStringKey
  
  kDRErrorStatusAdditionalSenseStringKey
  
  Ключ для словаря DRErrorStatus. Значение этого ключа является объектом CFString, содержащим локализованную строку, описывающую дополнительный смысл от данных чувственного опыта для отказа. Это значение является дополнительным и не будет присутствовать, если kDRErrorStatusSenseKey ключ не присутствует или если подходящая строка не существует для описания отказа.
  
  Доступный в OS X v10.2 и позже.
- kDRErrorStatusErrorInfoStringKey
  
  kDRErrorStatusErrorInfoStringKey
  
  Ключ для словаря DRErrorStatus. Значение этого ключа является объектом CFString, содержащим строку, предоставляющую дополнительную информацию для ошибки. Если подходящая строка не существует для описания отказа, это значение является дополнительным и может не присутствовать.
  
  Доступный в OS X v10.4 и позже.
- kDRErrorStatusErrorKey
  
  kDRErrorStatusErrorKey
  
  Ключ для словаря DRErrorStatus. Значение этого ключа является объектом CFNumber, содержащим значение OSStatus, соответствующее отказу.
  
  Доступный в OS X v10.2 и позже.
- kDRErrorStatusErrorStringKey
  
  kDRErrorStatusErrorStringKey
  
  Ключ для словаря DRErrorStatus. Значение этого ключа является объектом CFString, содержащим локализованную строку, описывающую kDRErrorStatusErrorKey ключ. Если подходящая строка не существует для описания отказа, это значение является дополнительным и может не присутствовать.
  
  Доступный в OS X v10.2 и позже.
- kDRErrorStatusKey
  
  kDRErrorStatusKey
  
  Ключ для словаря DRErrorStatus, возвращенного любым из DRxxxCopyStatus вызовы или kDRxxxStatusChangedNotifications, описать отказ. Значение этого ключа является объектом CFDictionary, содержащим код ошибки и информацию о смысле устройства.
  
  Доступный в OS X v10.2 и позже.
- kDRErrorStatusSenseCodeStringKey
  
  kDRErrorStatusSenseCodeStringKey
  
  Ключ для словаря DRErrorStatus. Значение этого ключа является объектом CFString, содержащим локализованную строку, описывающую ключ смысла от данных чувственного опыта для отказа. Это значение является дополнительным и не будет присутствовать, если kDRErrorStatusSenseKey ключ не присутствует или если подходящая строка не существует для описания отказа.
  
  Доступный в OS X v10.2 и позже.
- kDRErrorStatusSenseKey
  
  kDRErrorStatusSenseKey
  
  Ключ для словаря DRErrorStatus. Значение этого ключа является объектом CFData, содержащим данные чувственного опыта устройства, описывающие отказ. Это значение является дополнительным и может не присутствовать, если отказ не был связан с устройством, или если устройство перестало работать в пути, не обеспечивавшем значимые данные чувственного опыта.
  
  Доступный в OS X v10.2 и позже.
Ошибки DiscRecording
Объявление

Swift

var kDRInternalErr: UInt32 { get } var kDRDeviceAccessErr: UInt32 { get } var kDRDeviceBusyErr: UInt32 { get } var kDRDeviceCommunicationErr: UInt32 { get } var kDRDeviceInvalidErr: UInt32 { get } var kDRDeviceNotReadyErr: UInt32 { get } var kDRDeviceNotSupportedErr: UInt32 { get } var kDRMediaBusyErr: UInt32 { get } var kDRMediaNotPresentErr: UInt32 { get } var kDRMediaNotWritableErr: UInt32 { get } var kDRMediaNotSupportedErr: UInt32 { get } var kDRMediaNotBlankErr: UInt32 { get } var kDRMediaNotErasableErr: UInt32 { get } var kDRMediaInvalidErr: UInt32 { get } var kDRBurnUnderrunErr: UInt32 { get } var kDRBurnNotAllowedErr: UInt32 { get } var kDRDataProductionErr: UInt32 { get } var kDRVerificationFailedErr: UInt32 { get } var kDRTooManyTracksForDVDErr: UInt32 { get } var kDRBadLayoutErr: UInt32 { get } var kDRUserCanceledErr: UInt32 { get } var kDRFunctionNotSupportedErr: UInt32 { get } var kDRSpeedTestAlreadyRunningErr: UInt32 { get } var kDRInvalidIndexPointsErr: UInt32 { get } var kDRDoubleLayerL0DataZoneBlocksParamErr: UInt32 { get } var kDRDoubleLayerL0AlreadySpecifiedErr: UInt32 { get } var kDRAudioFileNotSupportedErr: UInt32 { get } var kDRBurnPowerCalibrationErr: UInt32 { get } var kDRBurnMediaWriteFailureErr: UInt32 { get } var kDRTrackReusedErr: UInt32 { get } var kDRFileModifiedDuringBurnErr: UInt32 { get } var kDRFileLocationConflictErr: UInt32 { get } var kDRTooManyNameConflictsErr: UInt32 { get } var kDRFilesystemsNotSupportedErr: UInt32 { get } var kDRDeviceCantWriteCDTextErr: UInt32 { get } var kDRDeviceBurnStrategyNotAvailableErr: UInt32 { get } var kDRDeviceCantWriteIndexPointsErr: UInt32 { get } var kDRDeviceCantWriteISRCErr: UInt32 { get } var kDRDeviceCantWriteSCMSErr: UInt32 { get } var kDRDevicePreGapLengthNotValidErr: UInt32 { get }

Objective C

enum { kDRFirstErr = 0x80020000, kDRInternalErr = kDRFirstErr, /* device errors */ kDRDeviceAccessErr = 0x80020020, kDRDeviceBusyErr = 0x80020021, kDRDeviceCommunicationErr = 0x80020022, kDRDeviceInvalidErr = 0x80020023, kDRDeviceNotReadyErr = 0x80020024, kDRDeviceNotSupportedErr = 0x80020025, /* media errors */ kDRMediaBusyErr = 0x80020040, kDRMediaNotPresentErr = 0x80020041, kDRMediaNotWritableErr = 0x80020042, kDRMediaNotSupportedErr = 0x80020043, kDRMediaNotBlankErr = 0x80020044, kDRMediaNotErasableErr = 0x80020045, kDRMediaInvalidErr = 0x80020046, /* burn errors */ kDRBurnUnderrunErr = 0x80020060, kDRBurnNotAllowedErr = 0x80020061, kDRDataProductionErr = 0x80020062, kDRVerificationFailedErr = 0x80020063, kDRTooManyTracksForDVDErr = 0x80020064, kDRBadLayoutErr = 0x80020065, kDRUserCanceledErr = 0x80020066, kDRFunctionNotSupportedErr = 0x80020067, kDRSpeedTestAlreadyRunningErr = 0x80020068, kDRInvalidIndexPointsErr = 0x80020069, kDRDoubleLayerL0DataZoneBlocksParamErr = 0x8002006A, kDRDoubleLayerL0AlreadySpecifiedErr = 0x8002006B, kDRAudioFileNotSupportedErr = 0x8002006C, kDRBurnPowerCalibrationErr = 0x8002006D, kDRBurnMediaWriteFailureErr = 0x8002006E, kDRTrackReusedErr = 0x8002006F, /* content errors */ kDRFileModifiedDuringBurnErr = 0x80020100, kDRFileLocationConflictErr = 0x80020101, kDRTooManyNameConflictsErr = 0x80020102, kDRFilesystemsNotSupportedErr = 0x80020103, /* drive feature errors */ kDRDeviceBurnStrategyNotAvailableErr = 0x80020200, kDRDeviceCantWriteCDTextErr = 0x80020201, kDRDeviceCantWriteIndexPointsErr = 0x80020202, kDRDeviceCantWriteISRCErr = 0x80020203, kDRDeviceCantWriteSCMSErr = 0x80020204, kDRDevicePreGapLengthNotValidErr = 0x80020205 };

Константы
- kDRInternalErr
  
  kDRInternalErr
  
  Ошибка Записи Внутреннего диска.
  
  Доступный в OS X v10.2 и позже.
- kDRDeviceAccessErr
  
  kDRDeviceAccessErr
  
  Устройство не доступно, аппаратные средства разъединяются и т.д.
  
  Доступный в OS X v10.2 и позже.
- kDRDeviceBusyErr
  
  kDRDeviceBusyErr
  
  Устройство используется другим процессом
  
  Доступный в OS X v10.2 и позже.
- kDRDeviceCommunicationErr
  
  kDRDeviceCommunicationErr
  
  Устройству не удалось ответить должным образом, неспособное восстановить или повторить.
  
  Доступный в OS X v10.2 и позже.
- kDRDeviceInvalidErr
  
  kDRDeviceInvalidErr
  
  Попытка была предпринята для использования недопустимого DRDeviceRef.
  
  Доступный в OS X v10.2 и позже.
- kDRDeviceNotReadyErr
  
  kDRDeviceNotReadyErr
  
  Устройство неспособно ответить теперь, попробуйте еще раз позже.
  
  Доступный в OS X v10.2 и позже.
- kDRDeviceNotSupportedErr
  
  kDRDeviceNotSupportedErr
  
  Устройство не поддерживается для требуемой работы записи.
  
  Доступный в OS X v10.2 и позже.
- kDRMediaBusyErr
  
  kDRMediaBusyErr
  
  Диск занят, обычно указывая, что объем является немонтируемым.
  
  Доступный в OS X v10.2 и позже.
- kDRMediaNotPresentErr
  
  kDRMediaNotPresentErr
  
  Диск не присутствует и должен быть.
  
  Доступный в OS X v10.2 и позже.
- kDRMediaNotWritableErr
  
  kDRMediaNotWritableErr
  
  Диск не перезаписываем, и должен быть.
  
  Доступный в OS X v10.2 и позже.
- kDRMediaNotSupportedErr
  
  kDRMediaNotSupportedErr
  
  Диск не поддерживается для требуемой работы записи.
  
  Доступный в OS X v10.2 и позже.
- kDRMediaNotBlankErr
  
  kDRMediaNotBlankErr
  
  Диск не является пробелом, и требуемой работе нужен он, чтобы быть.
  
  Доступный в OS X v10.2 и позже.
- kDRMediaNotErasableErr
  
  kDRMediaNotErasableErr
  
  Диск не является стираемым, и требуемой работе нужен он, чтобы быть.
  
  Доступный в OS X v10.3 и позже.
- kDRMediaInvalidErr
  
  kDRMediaInvalidErr
  
  Требуемая работа попыталась на недопустимых носителях.
  
  Доступный в OS X v10.5 и позже.
- kDRBurnUnderrunErr
  
  kDRBurnUnderrunErr
  
  Запись перестала работать, потому что устройство истощило свой буфер без защиты недогрузки записи.
  
  Доступный в OS X v10.2 и позже.
- kDRBurnNotAllowedErr
  
  kDRBurnNotAllowedErr
  
  Пользователю не разрешают гореть к этому устройству в этой системе.
  
  Доступный в OS X v10.2 и позже.
- kDRDataProductionErr
  
  kDRDataProductionErr
  
  Ошибка при создании данных для записи
  
  Доступный в OS X v10.2 и позже.
- kDRVerificationFailedErr
  
  kDRVerificationFailedErr
  
  Верификация данных перестала работать
  
  Доступный в OS X v10.2 и позже.
- kDRTooManyTracksForDVDErr
  
  kDRTooManyTracksForDVDErr
  
  Диски DVD могут содержать только одну дорожку
  
  Доступный в OS X v10.2 и позже.
- kDRBadLayoutErr
  
  kDRBadLayoutErr
  
  Слишком много дорожек или сеансов
  
  Доступный в OS X v10.2 и позже.
- kDRUserCanceledErr
  
  kDRUserCanceledErr
  
  Пользователь отменил запись
  
  Доступный в OS X v10.2 и позже.
- kDRFunctionNotSupportedErr
  
  kDRFunctionNotSupportedErr
  
  Производитель дорожки не может выполнить запрошенную функцию
  
  Доступный в OS X v10.2 и позже.
- kDRSpeedTestAlreadyRunningErr
  
  kDRSpeedTestAlreadyRunningErr
  
  Тест скорости уже работает на требуемой дорожке
  
  Доступный в OS X v10.5 и позже.
- kDRInvalidIndexPointsErr
  
  kDRInvalidIndexPointsErr
  
  Индексные точки были недопустимы (перекрытие, из диапазона, и т.д.)
  
  Доступный в OS X v10.5 и позже.
- kDRDoubleLayerL0DataZoneBlocksParamErr
  
  kDRDoubleLayerL0DataZoneBlocksParamErr
  
  Точка перехода уровня 0 недопустима
  
  Доступный в OS X v10.5 и позже.
- kDRDoubleLayerL0AlreadySpecifiedErr
  
  kDRDoubleLayerL0AlreadySpecifiedErr
  
  Точка перехода уровня 0 уже указана для этого носители
  
  Доступный в OS X v10.5 и позже.
- kDRAudioFileNotSupportedErr
  
  kDRAudioFileNotSupportedErr
  
  Производитель аудиофайла не поддерживает требуемый файл.
  
  Доступный в OS X v10.5 и позже.
- kDRBurnPowerCalibrationErr
  
  kDRBurnPowerCalibrationErr
  
  Устройству не удалось калибровать уровень мощности лазера для этого носители.
  
  Доступный в OS X v10.5 и позже.
- kDRBurnMediaWriteFailureErr
  
  kDRBurnMediaWriteFailureErr
  
  Запись перестала работать из-за средней ошибки при записи.
  
  Доступный в OS X v10.5 и позже.
- kDRTrackReusedErr
  
  kDRTrackReusedErr
  
  Одна или более дорожек были включены многократно в записи
  
  Доступный в OS X v10.4 и позже.
- kDRFileModifiedDuringBurnErr
  
  kDRFileModifiedDuringBurnErr
  
  Файл, измененный во время, сглаживается или горит
  
  Доступный в OS X v10.2 и позже.
- kDRFileLocationConflictErr
  
  kDRFileLocationConflictErr
  
  Конфликтные расположения указаны для двух файлов
  
  Доступный в OS X v10.2 и позже.
- kDRTooManyNameConflictsErr
  
  kDRTooManyNameConflictsErr
  
  Слишком много конфликтов имени файла для разрешения (10,000,000 или больше)
  
  Доступный в OS X v10.2 и позже.
- kDRFilesystemsNotSupportedErr
  
  kDRFilesystemsNotSupportedErr
  
  Выбранные файловые системы не допустимы для использования на этом носители
  
  Доступный в OS X v10.5 и позже.
- kDRDeviceCantWriteCDTextErr
  
  kDRDeviceCantWriteCDTextErr
  
  Устройство не поддерживает текст CD записи
  
  Доступный в OS X v10.4 и позже.
- kDRDeviceBurnStrategyNotAvailableErr
  
  kDRDeviceBurnStrategyNotAvailableErr
  
  Устройство не поддерживает требуемую стратегию записи этой записи
  
  Доступный в OS X v10.3 и позже.
- kDRDeviceCantWriteIndexPointsErr
  
  kDRDeviceCantWriteIndexPointsErr
  
  Устройство не поддерживает индексные точки записи
  
  Доступный в OS X v10.3 и позже.
- kDRDeviceCantWriteISRCErr
  
  kDRDeviceCantWriteISRCErr
  
  Устройство не поддерживает запись ISRC
  
  Доступный в OS X v10.3 и позже.
- kDRDeviceCantWriteSCMSErr
  
  kDRDeviceCantWriteSCMSErr
  
  Устройство не поддерживает запись SCMS
  
  Доступный в OS X v10.3 и позже.
- kDRDevicePreGapLengthNotValidErr
  
  kDRDevicePreGapLengthNotValidErr
  
  Устройство не поддерживает требуемую длину перед разрывом для дорожки
  
  Доступный в OS X v10.4 и позже.
Обсуждение

Ошибки возвратились из платформы Записи Диска. Все ошибки, возвращенные платформой Записи Диска, попадут в диапазон 0x80020000-> 0x8002FFFF.