Ссылка DRBurnSession.h

Конфигурация записи и пользовательский интерфейс прогресса для приложений Углерода

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

<DiscRecording/DiscRecording.h>
<Carbon/Carbon.h>
<AvailabilityMacros.h>

Функции

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


    
    DRBurnSessionBeginProgressDialog (_: _: _: _:)
    DRBurnSessionBeginProgressDialog

Представляет интерфейс прогресса как немодальное диалоговое окно.

Объявление

Swift

func DRBurnSessionBeginProgressDialog(_ burnSession: DRBurnSession!, _ layout: AnyObject!, _ options: UnsafeMutablePointer<DRBurnSessionProgressDialogOptions>, _ progressCallbacks: UnsafeMutablePointer<DRBurnSessionProgressCallbacks>)

Objective C

void DRBurnSessionBeginProgressDialog ( DRBurnSessionRef burnSession, CFTypeRef layout, DRBurnSessionProgressDialogOptions *options, DRBurnSessionProgressCallbacks *progressCallbacks );

Параметры

`burnSession`	Объект сеанса записи
`layout`	Расположение дорожек, которое будет использоваться для записи.
`options`	Указатель на структуру типа DRBurnSessionSetupDialogOptions.
`progressCallbacks`	Указатель на структуру типа DRBurnSessionProgressCallbacks. Если никакое пользовательское поведение не желаемо, этим указателем может быть NULL.

Обсуждение

Эта функция дарит пользователю немодальное диалоговое окно, показывающее прогресс записи.

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

Objective C

@import DiscRecordingUI;

Swift

import DiscRecordingUI

Доступность

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

DRBurnSessionCreate () DRBurnSessionCreate

Создает новый сеанс записи.

Объявление

Swift

func DRBurnSessionCreate() -> Unmanaged<DRBurnSession>!

Objective C

DRBurnSessionRef DRBurnSessionCreate ( void );

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

Ссылка на новый DRBurnSession.

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

Objective C

@import DiscRecordingUI;

Swift

import DiscRecordingUI

Доступность

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


    
    DRBurnSessionGetBurn (_:)
    DRBurnSessionGetBurn

Возвращает объект записи для этого сеанса.

Объявление

Swift

func DRBurnSessionGetBurn(_ burnSession: DRBurnSession!) -> Unmanaged<DRBurn>!

Objective C

DRBurnRef DRBurnSessionGetBurn ( DRBurnSessionRef burnSession );

Параметры


      burnSession

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

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

Ссылка на запись возражает для сеанса. Если диалоговое окно установки не было выполнено, или объект записи не был установлен с DRBurnSessionSetBurn, эта функция возвращает NULL.

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

Objective C

@import DiscRecordingUI;

Swift

import DiscRecordingUI

Доступность

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

DRBurnSessionGetTypeID () DRBurnSessionGetTypeID

Возвращает идентификатор типа всех экземпляров DRBurnSession.

Объявление

Swift

func DRBurnSessionGetTypeID() -> CFTypeID

Objective C

CFTypeID DRBurnSessionGetTypeID ( void );

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

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

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

Objective C

@import DiscRecordingUI;

Swift

import DiscRecordingUI

Доступность

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


    
    DRBurnSessionSetBurn (_: _:)
    DRBurnSessionSetBurn

Устанавливает объект записи для этого сеанса.

Объявление

Swift

func DRBurnSessionSetBurn(_ burnSession: DRBurnSession!, _ burn: DRBurn!)

Objective C

void DRBurnSessionSetBurn ( DRBurnSessionRef burnSession, DRBurnRef burn );

Параметры

`burnSession`	Сеанс записи. Если этим параметром не является допустимый DRBurnSessionRef, поведение не определено.
`burn`	Запись для использования для сеанса. Если этим параметром не является допустимый DRBurnRef, поведение не определено.

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

Objective C

@import DiscRecordingUI;

Swift

import DiscRecordingUI

Доступность

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


    
    DRBurnSessionSetupDialog (_: _: _:)
    DRBurnSessionSetupDialog

Представляет интерфейс установки как модальное диалоговое окно.

Объявление

Swift

func DRBurnSessionSetupDialog(_ burnSession: DRBurnSession!, _ options: UnsafeMutablePointer<DRBurnSessionSetupDialogOptions>, _ setupCallbacks: UnsafeMutablePointer<DRBurnSessionSetupCallbacks>) -> Int8

Objective C

SInt8 DRBurnSessionSetupDialog ( DRBurnSessionRef burnSession, DRBurnSessionSetupDialogOptions *options, DRBurnSessionSetupCallbacks *setupCallbacks );

Параметры

`burnSession`	Объект сеанса записи
`options`	Указатель на структуру типа DRBurnSessionSetupDialogOptions. Если никакая пользовательская конфигурация не требуется, этим указателем может быть NULL.
`setupCallbacks`	Указатель на структуру типа DRBurnSessionSetupCallbacks. Если никакое пользовательское поведение не желаемо, этим указателем может быть NULL.

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

Возвраты одна из констант определяются Диалоговыми Кодами Результата Сеанса Записи.

Обсуждение

Эта функция дарит пользователю модальное диалоговое окно, позволяющее им конфигурировать запись к своим пользовательским настройкам. Они включают: устройство для использования, извлечь ли носители по окончании, скорость записи и других. Функция не возвращается, пока пользователь не отклонил диалоговое окно.

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

Objective C

@import DiscRecordingUI;

Swift

import DiscRecordingUI

Доступность

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

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

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


    
    DRBurnSessionBurnCompleteProcPtr
    DRBurnSessionBurnCompleteProcPtr

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

Объявление

Swift

typealias DRBurnSessionBurnCompleteProcPtr = CFunctionPointer<((DRBurnSession!, DRBurn!) -> Boolean)>

Objective C

typedef Boolean ( *DRBurnSessionBurnCompleteProcPtr )( DRBurnSessionRef burnSession, DRBurnRef burn);

Параметры

`burnSession`	Объект сеанса записи.
`burn`	Только что закончившийся экземпляр записи.

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

Булево значение, управляющее дисплеем ошибочного диалогового окна сеанса записи.

Обсуждение

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

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

Objective C

@import DiscRecordingUI;

Swift

import DiscRecordingUI

Доступность

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


    
    DRBurnSessionDeviceCheckProcPtr
    DRBurnSessionDeviceCheckProcPtr

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

Объявление

Swift

typealias DRBurnSessionDeviceCheckProcPtr = CFunctionPointer<((DRBurnSession!, DRDevice!) -> Boolean)>

Objective C

typedef Boolean ( *DRBurnSessionDeviceCheckProcPtr )( DRBurnSessionRef burnSession, DRDeviceRef device);

Параметры

`burnSession`	Объект сеанса записи.
`device`	Устройство для исследования.

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

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

Обсуждение

Этот обратный вызов вызывают каждый раз, когда появляется новое устройство. Это - цель, должен позволить приложению фильтровать устройства вывода, не поддерживающие работу, которая будет выполняться. например, устройство может отфильтровать наш CD-R/Ws, если это - создание DVD appliacation.

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

Objective C

@import DiscRecordingUI;

Swift

import DiscRecordingUI

Доступность

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


    
    DRBurnSessionDeviceSelectionNotificationProcPtr
    DRBurnSessionDeviceSelectionNotificationProcPtr

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

Объявление

Swift

typealias DRBurnSessionDeviceSelectionNotificationProcPtr = CFunctionPointer<((DRBurnSession!, DRDevice!) -> Void)>

Objective C

typedef void ( *DRBurnSessionDeviceSelectionNotificationProcPtr )( DRBurnSessionRef burnSession, DRDeviceRef device);

Параметры

`burnSession`	Объект сеанса записи.
`device`	Недавно выбранное устройство.

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

Objective C

@import DiscRecordingUI;

Swift

import DiscRecordingUI

Доступность

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


    
    DRBurnSessionMediaCheckProcPtr
    DRBurnSessionMediaCheckProcPtr

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

Объявление

Swift

typealias DRBurnSessionMediaCheckProcPtr = CFunctionPointer<((DRBurnSession!, DRDevice!, UnsafeMutablePointer<Unmanaged<CFString>?>) -> Boolean)>

Objective C

typedef Boolean ( *DRBurnSessionMediaCheckProcPtr )( DRBurnSessionRef burnSession, DRDeviceRef device, CFStringRef *prompt);

Параметры

`burnSession`	Объект сеанса записи.
`device`	Устройство, содержащее носители для исследования.
`prompt`	Указатель на CFStringRef. Приложение может возвратить пользовательское сообщение для отображения в диалоговом окне установки.

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

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

Обсуждение

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

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

Objective C

@import DiscRecordingUI;

Swift

import DiscRecordingUI

Доступность

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

DRBurnSessionProgressBeginNotificationProcPtr DRBurnSessionProgressBeginNotificationProcPtr

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

Объявление

Swift

typealias DRBurnSessionProgressBeginNotificationProcPtr = CFunctionPointer<((DRBurnSession!) -> Void)>

Objective C

typedef void ( *DRBurnSessionProgressBeginNotificationProcPtr )( DRBurnSessionRef burnSession);

Параметры

burnSession

Объект сеанса записи.

Обсуждение

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

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

Objective C

@import DiscRecordingUI;

Swift

import DiscRecordingUI

Доступность

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

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

Объявление

Swift

typealias DRBurnSessionProgressFinishNotificationProcPtr = CFunctionPointer<((DRBurnSession!) -> Void)>

Objective C

typedef void ( *DRBurnSessionProgressFinishNotificationProcPtr )( DRBurnSessionRef burnSession);

Параметры

burnSession

Объект сеанса записи.

Обсуждение

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

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

Objective C

@import DiscRecordingUI;

Swift

import DiscRecordingUI

Доступность

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

Типы данных

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

DRBurnSessionProgressDialogOptionFlags DRBurnSessionProgressDialogOptionFlags

Указывает диалоговые параметры конфигурации прогресса.

Объявление

Swift

typealias DRBurnSessionProgressDialogOptionFlags = UInt32

Objective C

typedef UInt32 DRBurnSessionProgressDialogOptionFlags;

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

Objective C

@import DiscRecordingUI;

Swift

import DiscRecordingUI

Доступность

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

Объявление

Swift

typealias DRBurnSessionRef = DRBurnSession

Objective C

typedef struct __DRBurnSession* DRBurnSessionRef;

Обсуждение

Это - тип ссылки на экземпляры DRBurnSession.

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

Objective C

@import DiscRecordingUI;

Swift

import DiscRecordingUI

Доступность

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

Указывает диалоговые параметры конфигурации установки.

Объявление

Swift

typealias DRBurnSessionSetupDialogOptionFlags = UInt32

Objective C

typedef UInt32 DRBurnSessionSetupDialogOptionFlags;

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

Objective C

@import DiscRecordingUI;

Swift

import DiscRecordingUI

Доступность

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


      
      DRBurnSessionProgressCallbacks

Функции обратного вызова передали диалоговому окну прогресса.

Объявление

Objective C

struct DRBurnSessionProgressCallbacks { UInt32 version; DRBurnSessionProgressBeginNotificationProcPtr progressWillBegin; DRBurnSessionProgressFinishNotificationProcPtr progressDidFinish; DRBurnSessionBurnCompleteProcPtr burnDidFinish; };

Поля

`version`	Идентифицирует версию этой структуры.
`progressWillBegin`	Указатель на DRBurnSessionProgressBeginNotificationProcPtr. Значением этого поля может быть NULL.
`progressDidFinish`	Указатель на DRBurnSessionProgressFinishNotificationProcPtr. Значением этого поля может быть NULL.
`burnDidFinish`	Указатель на DRBurnSessionBurnCompleteProcPtr. Значением этого поля может быть NULL.


      
      DRBurnSessionProgressDialogOptions

Опции передали в диалоговое окно прогресса для конфигурирования его.

Объявление

Objective C

struct DRBurnSessionProgressDialogOptions { UInt32 version; DRBurnSessionProgressDialogOptionFlags dialogOptionFlags; /* option flags for affecting the dialog's behavior */ CFStringRef description; /* optional description of the burn */ };

Поля

`version`	Идентифицирует версию этой структуры.
`dialogOptionFlags`	Одна из нескольких констант, определенных типом данных DRBurnSessionProgressDialogOptionFlags, как описано в Диалоговых Флагах Опции Прогресса Записи.
`description`	CFStringRef, определяющий пользовательское описание, которое будет использоваться для диалогового окна. Если Вы не обеспечиваете эту строку (передающий NULL), нормальное описание используется.


      
      DRBurnSessionSetupCallbacks

Функции обратного вызова передали диалоговому окну установки.

Объявление

Objective C

struct DRBurnSessionSetupCallbacks { UInt32 version; DRBurnSessionDeviceCheckProcPtr deviceShouldBeTarget; DRBurnSessionMediaCheckProcPtr containsSuitableMedia; DRBurnSessionDeviceSelectionNotificationProcPtr deviceSelectionChanged; };

Поля

`version`	Идентифицирует версию этой структуры.
`deviceShouldBeTarget`	Указатель на DRBurnSessionDeviceCheckProcPtr. Значением этого поля может быть NULL.
`containsSuitableMedia`	Указатель на DRBurnSessionMediaCheckProcPtr. Значением этого поля может быть NULL.
`deviceSelectionChanged`	Указатель на DRBurnSessionDeviceSelectionNotificationProcPtr. Значением этого поля может быть NULL.


      
      DRBurnSessionSetupDialogOptions

Опции передали в диалоговое окно установки для конфигурирования его.

Объявление

Objective C

struct DRBurnSessionSetupDialogOptions { UInt32 version; DRBurnSessionSetupDialogOptionFlags dialogOptionFlags; /* option flags for affecting the dialog's behavior */ CFStringRef defaultButtonTitle; /* title of default button */ };

Поля

`version`	Идентифицирует версию этой структуры.
`dialogOptionFlags`	Одна из нескольких констант, определенных типом данных DRBurnSessionSetupDialogOptionFlags, как описано в Диалоговых Флагах Опции Установки Записи.
`defaultButtonTitle`	CFStringRef, определяющий пользовательский заголовок, который будет использоваться для кнопки диалогового окна по умолчанию. Если Вы не обеспечиваете эту строку (передающий NULL), нормальный заголовок кнопки используется.

Константы

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

Диалоговые флаги опции прогресса записи
Объявление

Swift

var kBurnSessionProgressDialogDefaultOptions: Int { get } var kBurnSessionProgressDialogDisplayVerboseProgress: Int { get }

Objective C

enum { kBurnSessionProgressDialogDefaultOptions = 0x00000000 , /* use defaults for all the options */ kBurnSessionProgressDialogDisplayVerboseProgress = 0x00000001 /* Report all status changes in detail */ };

Константы
- kBurnSessionProgressDialogDefaultOptions
  
  kBurnSessionProgressDialogDefaultOptions
  
  Используйте значения по умолчанию для всех опций
  
  Доступный в OS X v10.3 и позже.
- kBurnSessionProgressDialogDisplayVerboseProgress
  
  kBurnSessionProgressDialogDisplayVerboseProgress
  
  Сообщите обо всех изменениях состояния подробно
  
  Доступный в OS X v10.3 и позже.
Обсуждение

Флаги раньше конфигурировали прогресс записи диалоговое поведение
Диалоговые коды результата сеанса записи
Объявление

Swift

var kDRBurnSessionOK: Int { get } var kDRBurnSessionCancel: Int { get }

Objective C

enum { kDRBurnSessionOK = 1, kDRBurnSessionCancel = 0, };

Константы
- kDRBurnSessionOK
  
  kDRBurnSessionOK
  
  Значение, возвращенное диалоговым окном установки, когда пользователь подтвердил установку записи.
  
  Доступный в OS X v10.3 и позже.
- kDRBurnSessionCancel
  
  kDRBurnSessionCancel
  
  Значение, возвращенное диалоговым окном установки, когда пользователь отменил установку записи.
  
  Доступный в OS X v10.3 и позже.
Обсуждение

Коды возврата для сеанса записи устанавливают диалоговое окно.
Диалоговые флаги опции установки записи
Объявление

Swift

var kBurnSessionSetupDialogDefaultOptions: UInt32 { get } var kBurnSessionSetupDialogForceClosedDiscs: UInt32 { get } var kBurnSessionSetupDialogDontHandleReservations: UInt32 { get } var kBurnSessionSetupDialogAllowTestBurns: UInt32 { get }

Objective C

enum { kBurnSessionSetupDialogDefaultOptions = 0x00000000 , /* use defaults for all the options */ kBurnSessionSetupDialogForceClosedDiscs = 0x00000001 , /* Force discs to be closed (not appendable ) */ kBurnSessionSetupDialogDontHandleReservations = 0x00000002 , /* Don't handle media reservations. Application handles them itself */ kBurnSessionSetupDialogAllowTestBurns = 0x80000004 /* Allow the user to perform a test burn */ };

Константы
- kBurnSessionSetupDialogDefaultOptions
  
  kBurnSessionSetupDialogDefaultOptions
  
  Используйте значения по умолчанию для всех опций
  
  Доступный в OS X v10.3 и позже.
- kBurnSessionSetupDialogForceClosedDiscs
  
  kBurnSessionSetupDialogForceClosedDiscs
  
  Диски силы, которые будут закрыты (не appendable)
  
  Доступный в OS X v10.3 и позже.
- kBurnSessionSetupDialogDontHandleReservations
  
  kBurnSessionSetupDialogDontHandleReservations
  
  Сеанс записи не обрабатывает резервирование носителей. Приложение обрабатывает их само
  
  Доступный в OS X v10.3 и позже.
- kBurnSessionSetupDialogAllowTestBurns
  
  kBurnSessionSetupDialogAllowTestBurns
  
  Позвольте пользователю выполнять тестовую запись
  
  Доступный в OS X v10.3 и позже.
Обсуждение

Флаги раньше конфигурировали диалоговое поведение установки записи
Версия структуры DRBurnSessionProgressDialogOptions

Объявление

Objective C

enum { kBurnSessionProgressDialogOptionsCurrentVersion = 1 };
Версия структуры DRBurnSessionSetupCallbacks

Объявление

Objective C

enum { kDRBurnSessionSetupCallbacksCurrentVersion = 1 };
Версия структуры DRBurnSessionSetupDialogOptions

Объявление

Objective C

enum { kBurnSessionSetupDialogOptionsCurrentVersion = 1 };
версия структуры kDRBurnProgressSetupCallbacksCurrentVersion

Объявление

Objective C

enum { kDRBurnProgressSetupCallbacksCurrentVersion = 1 };