Ссылка DRContentFile.h

Объекты файла используются в создании файловой системы.

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

<DiscRecording/DRContentObject.h>
<CoreFoundation/CFURL.h>
<AvailabilityMacros.h>

Функции

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

DRFileCreateReal (_:) DRFileCreateReal

Создает новое реальное соответствие объекта файла данному FSRef.

Объявление

Swift

func DRFileCreateReal(_ fsRef: UnsafePointer<FSRef>) -> Unmanaged<DRFile>!

Objective C

DRFileRef DRFileCreateReal ( const FSRef *fsRef );

Параметры

fsRef

FSRef ссылка на дисковый файл.

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

Недавно создаваемый файл, или NULL.

Обсуждение

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

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

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

Доступный в OS X v10.2 и позже.
DRFileCreateRealWithURL (_:) DRFileCreateRealWithURL

Создает новое реальное соответствие объекта файла данному файлу URL.

Объявление

Swift

func DRFileCreateRealWithURL(_ urlRef: CFURL!) -> Unmanaged<DRFile>!

Objective C

DRFileRef DRFileCreateRealWithURL ( const CFURLRef urlRef );

Параметры

urlRef

Ссылка CFURLRef на дисковый файл.

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

Возвращает ссылку на недавно создаваемый реальный объект файла, или NULL.

Обсуждение

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

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

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

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


    
    DRFileCreateVirtualLink (_: _: _:)
    DRFileCreateVirtualLink

Создает виртуальный файл или объект папки в форме ссылки к другому файлу или папке в иерархии.

Объявление

Swift

func DRFileCreateVirtualLink(_ original: DRFSObject!, _ linkType: DRLinkType, _ fsKey: CFString!) -> Unmanaged<DRFile>!

Objective C

DRFileRef DRFileCreateVirtualLink ( DRFSObjectRef original, DRLinkType linkType, CFStringRef fsKey );

Параметры

`original`	Файл или папка для соединения с.
`linkType`	Тип ссылки для создания. Посмотрите перечисление DRLinkType.
`fsKey`	Система конечного файла для ссылки. Различные ключи определяются в DRContentProperties.h.

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

Ссылка на недавно создаваемый виртуальный файл или объект папки.

Обсуждение

Диск, Записывающий в настоящее время, поддерживает четыре типа канала: символьные ссылки, жесткие ссылки, псевдонимы Средства поиска и символьная ссылка комбинации / псевдонимы Средства поиска.

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

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

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

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


    
    DRFileCreateVirtualWithCallback (_: _: _:)
    DRFileCreateVirtualWithCallback

Создает виртуальный объект файла, который будет заполнен в во время производства данных функцией обратного вызова.

Объявление

Swift

func DRFileCreateVirtualWithCallback(_ baseName: CFString!, _ fileProc: DRFileProc, _ fileProcRefCon: UnsafeMutablePointer<Void>) -> Unmanaged<DRFile>!

Objective C

DRFileRef DRFileCreateVirtualWithCallback ( CFStringRef baseName, DRFileProc fileProc, void *fileProcRefCon );

Параметры

`baseName`	Базовое имя для присвоения к новому виртуальному файлу. Для получения информации о базовых именах и как работы Записи Диска с ними, посмотрите DRFSObjectSetBaseName и DRFSObjectSetSpecificName.
`fileProc`	Ваша реализованная приложением функция обратного вызова для генерации данных файла.
`fileProcRefCon`	Дополнительный ссылочный контекст для обратного вызова для использования.

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

Возвращает ссылку на недавно создаваемый виртуальный объект файла, или NULL.

Обсуждение

Виртуальный файл является объектом файла, не соответствующим никакому реальному файлу на диске, но представляющим файл, Вы хотите появиться в файловой структуре диска, который Вы записываете. Это создается и изменило функции 'содержания' Записи Диска использования - см. документацию для DRContentObject.h.

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

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

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

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


    
    DRFileCreateVirtualWithData (_: _: _:)
    DRFileCreateVirtualWithData

Создает виртуальный объект файла с указанными данными.

Объявление

Swift

func DRFileCreateVirtualWithData(_ baseName: CFString!, _ fileData: UnsafeMutablePointer<Void>, _ fileDataLength: UInt32) -> Unmanaged<DRFile>!

Objective C

DRFileRef DRFileCreateVirtualWithData ( CFStringRef baseName, void *fileData, UInt32 fileDataLength );

Параметры

`baseName`	Базовое имя для присвоения к новому виртуальному файлу.
`fileData`	Указатель на данные для файла. Может быть `NULL` если `inFileLength` нуль.
`fileDataLength`	Длина данных в байтах.

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

Возвращает ссылку на недавно создаваемый виртуальный объект файла, или NULL.

Обсуждение

Данные файла, переданные в к этой функции, копируются внутренне. Несмотря на то, что возможно создать файлы произвольного размера с этой функцией, необходимо ограничить файлы, создаваемые таким образом к разумному размеру, такие как 100K или меньше, потому что каждый файл использует соответствующий объем памяти.

В файловых системах мультиветвления данные файла используются для ветви данных.

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

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

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

DRFileGetTypeID () DRFileGetTypeID

Возвращает идентификатор типа всех объектов DRFile.

Объявление

Swift

func DRFileGetTypeID() -> CFTypeID

Objective C

CFTypeID DRFileGetTypeID ( void );

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

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

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

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

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


    
    DRFileProc
    DRFileProc

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

Объявление

Swift

typealias DRFileProc = CFunctionPointer<((UnsafeMutablePointer<Void>, DRFile!, DRFileMessage, UnsafeMutablePointer<Void>) -> OSStatus)>

Objective C

typedef OSStatus ( *DRFileProc)( void *refCon, DRFileRef file, DRFileMessage message, void *ioParam);

Параметры

`refCon`	Ссылочный контекст для Вашего использования, установленного, когда регистрируется обратный вызов.
`file`	Производимый объект файла.
`message`	Отправленный механизмом Записи Диска для указания типа данных этому нужно приложение для предоставления. Различные сообщения определяются в перечислении DRFileMessage.
`ioParam`	Параметры специфичны для сообщения. Посмотрите перечисление DRFileMessage.

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

Ваше приложение должно возвратить kDRFunctionNotSupportedErr, когда сообщение было передано, что это не отвечает на.

Обсуждение

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

Если Вы называете свою функцию MyDRFileCallback, Вы объявили бы его как это:

       
   				OSStatus MyDRFileCallback (
   					void			*refCon,
   					DRFileRef		file,
   					DRFileMessage	message,
   					void			*ioParam
   				);

Ваш обратный вызов помещает запрошенные данные

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

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

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

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

Типы данных

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

DRFileForkIndex DRFileForkIndex

Индекс, используемый для доступа к ветвлениям файла.

Объявление

Swift

typealias DRFileForkIndex = UInt32

Objective C

typedef UInt32 DRFileForkIndex;

Обсуждение

Ветвь данных и ветвь ресурсов всегда фиксировали индексы. Другие ветвления могут быть позволены в будущем.

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

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

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

Введите используемый для определения запросов на размере ветвления.

Объявление

Swift

typealias DRFileForkSizeQuery = UInt32

Objective C

typedef UInt32 DRFileForkSizeQuery;

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

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

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

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

Объявление

Swift

typealias DRFileMessage = UInt32

Objective C

typedef UInt32 DRFileMessage;

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

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

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

Типы канала, доступные для функции DRFileCreateVirtualLink.

Объявление

Swift

typealias DRLinkType = UInt32

Objective C

typedef UInt32 DRLinkType;

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

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

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


      
      DRFileForkSizeInfo

Структура, используемая при запросе размеров ветвления.

Объявление

Objective C

struct DRFileForkSizeInfo { DRFileForkIndex fork; DRFileForkSizeQuery query; UInt64 size; };

Поля

`fork`	(в) котором требуют ветвление
`query`	(в) типе запроса, оценки или фактический
`size`	возвращенный размер


      
      DRFileProductionInfo

Структура используется обратным вызовом DRFileProc во время производства дорожки.

Объявление

Objective C

struct DRFileProductionInfo { UInt64 requestedAddress; void *buffer; UInt32 reqCount; UInt32 actCount; UInt32 blockSize; DRFileForkIndex fork; };

Поля

`requestedAddress`	адрес байта, который запрашивает механизм записи
`buffer`	буферизуйте для создания в
`reqCount`	число байтов требуют
`actCount`	(в) числе байтов Вы фактически произвели
`blockSize`	текущий размер блока, необходимо всегда возвращать сеть магазинов этого
`fork`	какое ветвление требуют

Константы

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

DRFileFork indicies
Объявление

Swift

var kDRFileForkData: Int { get } var kDRFileForkResource: Int { get }

Objective C

enum { kDRFileForkData = 0, kDRFileForkResource = 1 };

Константы
- kDRFileForkData
  
  kDRFileForkData
  
  Как правило, ветвь данных содержит основную информацию для файла и является ветвлением, используемым для файлов, таких как JPEGs, текстовые файлы, и т.д.
  
  Доступный в OS X v10.2 и позже.
- kDRFileForkResource
  
  kDRFileForkResource
  
  Как правило, ветвь ресурсов содержит вторичные метаданные, которые не важны для основного содержания файла и могут безопасно быть проигнорированы, когда файл отправляется в файловую систему или OS, не поддерживающий многократные ветвления. Посмотрите Внутренний Macintosh: Ресурсы для получения дополнительной информации о формате ветви ресурсов.
  
  Доступный в OS X v10.2 и позже.
Обсуждение

Индекс, используемый для доступа к ветвлениям файла.
DRFileForkSizeQuery contants
Объявление

Swift

var kDRFileForkSizeActual: Int { get } var kDRFileForkSizeEstimate: Int { get }

Objective C

enum { kDRFileForkSizeActual = 0, kDRFileForkSizeEstimate = 1 };

Константы
- kDRFileForkSizeActual
  
  kDRFileForkSizeActual
  
  Указывает запрос на фактический размер.
  
  Доступный в OS X v10.2 и позже.
- kDRFileForkSizeEstimate
  
  kDRFileForkSizeEstimate
  
  Указывает запрос на предполагаемый размер.
  
  Доступный в OS X v10.2 и позже.
Обсуждение

Введите используемый для определения запросов на размере ветвления.
Константы DRFileMessage
Объявление

Swift

var kDRFileMessageForkSize: Int { get } var kDRFileMessagePreBurn: Int { get } var kDRFileMessageProduceData: Int { get } var kDRFileMessageVerificationStarting: Int { get } var kDRFileMessagePostBurn: Int { get } var kDRFileMessageRelease: Int { get }

Objective C

enum { kDRFileMessageForkSize = 'fsiz', kDRFileMessagePreBurn = 'pre ', kDRFileMessageProduceData = 'prod', kDRFileMessageVerificationStarting = 'vrfy', kDRFileMessagePostBurn = 'post', kDRFileMessageRelease = 'bye ' };

Константы
- kDRFileMessageForkSize
  
  kDRFileMessageForkSize
  
  Указывает запрос на Ваш обратный вызов DRFileProc для предоставления размера дорожки файла.
  
  Ваш обратный вызов DRFileProc должен реагировать на это сообщение путем размещения требуемого размера ветвления файла в структуру DRFileForkSizeInfo, на которую указывает обратный вызов ioParam параметр. Ваш обратный вызов может получить это сообщение в любое время после того, как был создан объект файла.
  
  На вводе, структура fork поле указывает, какое ветвление о Вас спрашивают, как определено в перечислении DRFileForkIndex.
  
  Также на вводе, структура query поле указывает, просят ли Вас относительно предполагаемого или фактического размера ветвления, как определено в перечислении DRFileForkSizeQuery.
  
  Когда query полем является DRFileForkSizeQuery, Вас просят относительно оценки заключительного размера ветвления, возможно для механизма записи для оценки размера дорожки. Вы не должны быть точными, но Ваша оценка должна допустить ошибку на высокой стороне. В любое время может быть выполнен этот вызов.
  
  Когда query поле является kDRFileForkSizeActual, Вас просят относительно фактического размера ветвления использоваться в записи. Этот вызов выполняется только в фазе записи.
  
  Доступный в OS X v10.2 и позже.
- kDRFileMessagePreBurn
  
  kDRFileMessagePreBurn
  
  Указывает, что Ваше приложение должно выполнить всю необходимую подготовку к записи.
  
  Ваш обратный вызов DRFileProc должен реагировать на это сообщение, говоря Вашему приложению открыть файлы или выполнить любую другую необходимую работу подготовки перед записью. Механизм записи отправляет это сообщение перед записью, но после того, как вся иерархия диска полностью на месте. Можно запросить иерархию
  
  После этого вызова содержание записи заблокировано вниз, и необходимо быть в состоянии реагировать на сообщение kDRFileMessageForkSize с точными значениями.
  
  Отправленный перед записью. Обратный вызов ioParam параметр проигнорирован.
  
  Доступный в OS X v10.2 и позже.
- kDRFileMessageProduceData
  
  kDRFileMessageProduceData
  
  Отправленный во время записи (после того, как вызов перед записью). Обратный вызов ioParam параметр указывает на структуру DRFileProductionInfo. Скорость критически важна во время этого вызова. Необходимо произвести данные максимально быстро и попытаться не выполнить любые длительные задачи.
  
  Вас можно попросить произвести дважды, один раз во время фактической записи и один раз во время проверки.
  
  Доступный в OS X v10.2 и позже.
- kDRFileMessageVerificationStarting
  
  kDRFileMessageVerificationStarting
  
  Отправленный во время записи (после того, как вызов перед записью, после производства, перед вызовом постзаписи), чтобы указать, что проверка собирается начаться. Обратный вызов ioParam параметр проигнорирован.
  
  Это было бы надлежащим местом, чтобы искать назад на начало файлов, сбросить конечные автоматы или сделать то независимо от того, что необходимо, чтобы подготовить производить снова.
  
  Доступный в OS X v10.2 и позже.
- kDRFileMessagePostBurn
  
  kDRFileMessagePostBurn
  
  Отправленный в конце записи. Обратный вызов ioParam параметр проигнорирован.
  
  Это было бы надлежащим местом, чтобы закрыть файлы или выполнить любую другую необходимую работу разрушения. Этот вызов будет всегда выполняться независимо от того, успешно выполнилась ли запись или перестала работать.
  
  Доступный в OS X v10.2 и позже.
- kDRFileMessageRelease
  
  kDRFileMessageRelease
  
  Отправленный, когда выпущен DRFileRef. Обратный вызов ioParam параметр проигнорирован.
  
  Никакие дальнейшие сообщения не будут отправлены за этим объектом. Это было бы подходящим временем для выпуска любой памяти, выделенной объектом (ли в refCon или где-либо еще).
  
  Доступный в OS X v10.2 и позже.
Обсуждение

Сообщения отправили к обратному вызову DRFileProc во время записи.
DRLinkType contants
Объявление

Swift

var kDRLinkTypeHardLink: Int { get } var kDRLinkTypeSymbolicLink: Int { get } var kDRLinkTypeFinderAlias: Int { get }

Objective C

enum { kDRLinkTypeHardLink = 1, kDRLinkTypeSymbolicLink = 2, kDRLinkTypeFinderAlias = 3 };

Константы
- kDRLinkTypeHardLink
  
  kDRLinkTypeHardLink
  
  Тип канала для жестких ссылок.
  
  Доступный в OS X v10.2 и позже.
- kDRLinkTypeSymbolicLink
  
  kDRLinkTypeSymbolicLink
  
  Тип канала для символьных ссылок.
  
  Доступный в OS X v10.2 и позже.
- kDRLinkTypeFinderAlias
  
  kDRLinkTypeFinderAlias
  
  Тип канала для псевдонимов Средства поиска.
  
  Доступный в OS X v10.2 и позже.
Обсуждение

Константы типа канала используются функцией DRFileCreateVirtualLink.