Компонентная ссылка данных для QuickTime

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

Функции

Функции кодека данных


    
    DataCodecBeginInterruptSafe
    DataCodecBeginInterruptSafe

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataCodecBeginInterruptSafe ( DataCodecComponent dc, unsigned long maxSrcSize );

Параметры

`dc`	Экземпляр компрессора или компонента декомпрессора для этого запроса. Ваше программное обеспечение получает эту ссылку при вызове Менеджера компонентов `OpenComponent` или `OpenDefaultComponent` функция.
`maxSrcSize`	Максимальный размер блока данных, который будет сжат или распакован в байтах.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

Специальные замечания

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

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataCodecCompress
    DataCodecCompress

(OS X v10.9)

Данные сжатий с помощью указанного компонента компрессора.

Объявление

Objective C

ComponentResult DataCodecCompress ( DataCodecComponent dc, void *srcData, UInt32 srcSize, void *dstData, UInt32 dstBufferSize, UInt32 *actualDstSize, UInt32 *decompressSlop );

Параметры

`dc`	Компонент компрессора к используемому.
`srcData`	Указатель на данные, которые будут сжаты.
`srcSize`	Размер данных, которые будут сжаты в байтах.
`dstData`	Указатель на буфер, в котором можно хранить сжатые данные.
`dstBufferSize`	Размер буфера, в котором можно хранить сжатые данные в байтах.
`actualDstSize`	Размер сжатых данных, создававшихся в байтах.
`decompressSlop`	Число байтов, которые должны быть добавлены к размеру буфера распаковки, если распаковка происходит на месте.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Прежде, чем вызвать эту функцию, необходимо вызвать DataCodecGetCompressBufferSize получить максимальный возможный размер сжатых данных, которые будут возвращены. Можно тогда использовать это значение в качестве значения dstBufferSize параметр. Обратите внимание на то, что буфер для сжатых данных, которые являются тем же размером как несжатые данные, может не быть достаточно большим: в некоторых случаях размер сжатых данных может быть больше, чем размер распакованных данных. При сжатии данных необходимо сохранить размер данных перед сжатием в начале файла, сразу перед сжатыми данными. Это позволяет Вам получать размер распакованных данных и выделять буфер для того, чтобы хранить распакованные данные перед вызовом DataCodecDecompress.

Специальные замечания

Можно сжать спрайты путем вызывания этой функции. Если Вы делаете, необходимо включать несжатый размер выборки в начале выборки, перед сжатыми данными, и сохранить component подтип компрессора данных раньше сжимал спрайт в decompressorType поле выборки SpriteDescription структура. Можно также сжать QuickDraw 3D выборки носителей путем вызывания этой функции.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataCodecDecompress
    DataCodecDecompress

(OS X v10.9)

Данные распаковок с помощью указанного компонента компрессора.

Объявление

Objective C

ComponentResult DataCodecDecompress ( DataCodecComponent dc, void *srcData, UInt32 srcSize, void *dstData, UInt32 dstBufferSize );

Параметры

`dc`	Компонент декомпрессора к используемому.
`srcData`	Указатель на данные, которые будут распакованы.
`srcSize`	Размер данных, которые будут распакованы в байтах.
`dstData`	Указатель на буфер, в котором можно хранить распакованные данные.
`dstBufferSize`	Размер буфера, в котором можно хранить распакованные данные в байтах.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Прежде, чем выделить буфер, в котором можно хранить распакованные данные, необходимо получить размер распакованных данных. Размер обычно сохранен в начале файла, сразу перед сжатыми данными.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataCodecEndInterruptSafe
    DataCodecEndInterruptSafe

(OS X v10.9)

Высвобождает средства, используемые DataCodecBeginInterruptSafe.

Объявление

Objective C

ComponentResult DataCodecEndInterruptSafe ( DataCodecComponent dc );

Параметры

`dc`	Экземпляр компрессора или компонента декомпрессора для этого запроса.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.

Идентификация ссылок на данные


    
    DataHCompareDataRef
    DataHCompareDataRef

(OS X v10.9)

Сравнивает предоставленную ссылку на данные с ее текущей ссылкой на данные и возвращает булево значение, указывающее, эквивалентны ли ссылки на данные (т.е. эти две ссылки на данные идентифицируют тот же контейнер).

Объявление

Objective C

ComponentResult DataHCompareDataRef ( DataHandler dh, Handle dataRef, Boolean *equal );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`dataRef`	Ссылка на данные, чтобы быть по сравнению с текущей ссылкой на данные Вашего компонента. Различные типы контейнеров могут потребовать различных типов ссылок на данные. Например, в то время как ссылка на основанный на файле фильм может быть псевдонимом, ссылка на основанный на памяти фильм может быть дескриптором. Основанный на памяти обработчик данных Apple для Macintosh использует дескрипторы (и имеет значение подтипа `'hndl'`), в то время как менеджер по Псевдониму использования обработчика данных HFS искажает (его значение подтипа `'alis'`). Посмотрите `Data References`.
`equal`	Указатель на булевскую переменную. Если эти две ссылки на данные идентифицируют тот же контейнер, Ваш компонент должен установить ту булевскую переменную в TRUE. Иначе, установите булевскую переменную в FALSE.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

Специальные замечания

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

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetDataRef
    DataHGetDataRef

(OS X v10.9)

Получает текущую ссылку на данные Вашего компонента.

Объявление

Objective C

ComponentResult DataHGetDataRef ( DataHandler dh, Handle *dataRef );

Параметры

dh

Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.


      dataRef

Указатель на дескриптор ссылки на данные. Ваш компонент должен сделать копию своей текущей ссылки на данные в дескрипторе и возврате, обрабатывающих в этом поле. Клиентская программа ответственна за избавление от того дескриптора. Различные типы контейнеров могут потребовать различных типов ссылок на данные. Например, в то время как ссылка на основанный на файле фильм может быть псевдонимом, ссылка на основанный на памяти фильм может быть дескриптором. Основанный на памяти обработчик данных Apple для Macintosh использует дескрипторы (и имеет значение подтипа 'hndl'), в то время как менеджер по Псевдониму использования обработчика данных HFS искажает (его значение подтипа 'alis'). Посмотрите Data References.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHResolveDataRef
    DataHResolveDataRef

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHResolveDataRef ( DataHandler dh, Handle theDataRef, Boolean *wasChanged, Boolean userInterfaceAllowed );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`theDataRef`	Ссылка на данные, которая будет разрешена. Различные типы контейнеров могут потребовать различных типов ссылок на данные. Например, в то время как ссылка на основанный на файле фильм может быть псевдонимом, ссылка на основанный на памяти фильм может быть дескриптором. Основанный на памяти обработчик данных Apple для Macintosh использует дескрипторы (и имеет значение подтипа `'hndl'`), в то время как менеджер по Псевдониму использования обработчика данных HFS искажает (его значение подтипа `'alis'`). Посмотрите `Data References`.
`wasChanged`	Указатель на булевскую переменную. Если в определении местоположения контейнера Ваш обработчик данных обновляет информацию в ссылке на данные, Ваш компонент должен установить ту булевскую переменную в TRUE.
`userInterfaceAllowed`	Указывает, может ли Ваш компонент взаимодействовать с пользователем при определении местоположения `container`. Если этот параметр устанавливается на ПРАВДА, Ваш компонент может попросить, чтобы пользователь помог определить местоположение контейнера (например, путем представления диалогового окна Find File).

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Эта функция разрешает Вашему компоненту определять местоположение контейнера ссылки на данные. Эта функция эквивалентна менеджеру по Псевдониму Mac OS ResolveAlias функция. Клиентская программа просит, чтобы Ваш компонент определил местоположение контейнера, связанного со ссылкой определенных данных. Если Ваш компонент решает, что ссылка на данные должна быть обновлена с более точной информацией о расположении, это должно поместить новую информацию в предоставленную ссылку на данные (и установить булевскую переменную, именуемую wasChanged параметр к TRUE). Клиентские программы могут коррелировать ссылки на данные с обработчиками данных путем соответствия значения подтипа компонента data ссылочный тип; значение подтипа указывает тип ссылки на данные поддержки компонента. Все обработчики данных с тем же значением подтипа должны поддерживать тот же тип ссылки на данные.

Специальные замечания

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

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHSetDataRef
    DataHSetDataRef

(OS X v10.9)

Присваивает ссылку на данные Вашему компоненту обработчика данных.

Объявление

Objective C

ComponentResult DataHSetDataRef ( DataHandler dh, Handle dataRef );

Параметры

dh

Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.


      dataRef

Ссылка на данные. Этот параметр содержит дескриптор к информации, идентифицирующей рассматриваемый контейнер. Различные типы контейнеров могут потребовать различных типов ссылок на данные. Например, в то время как ссылка на основанный на файле фильм может быть псевдонимом, ссылка на основанный на памяти фильм может быть дескриптором. Например, основанный на памяти обработчик данных Apple для Macintosh использует дескрипторы (и имеет значение подтипа 'hndl'), в то время как менеджер по Псевдониму использования обработчика данных HFS искажает (его значение подтипа 'alis'). Клиентская программа ответственна за избавление от дескриптора, таким образом, Ваш компонент должен сделать копию из него. Посмотрите Data References.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

Специальные замечания

Обратите внимание на то, что тип ссылки на данные всегда соответствует типу, который Ваш компонент поддерживает, и что Вы указываете в component значение подтипа Вашего обработчика данных. В результате клиентская программа не обеспечивает значение типа ссылки на данные (в отличие от функций ссылки на данные Панели инструментов Фильма).

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.

Управление компонентами обработчика данных


    
    DataHFlushCache
    DataHFlushCache

(OS X v10.9)

Отбрасывает содержание любых кэшируемых буферов чтения.

Объявление

Objective C

ComponentResult DataHFlushCache ( DataHandler dh );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Обратите внимание на то, что эта функция не лишает законной силы запросов чтения с очередями (сделанный путем вызова компонента DataHScheduleData функция).

Специальные замечания

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

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHFlushData
    DataHFlushData

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHFlushData ( DataHandler dh );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Эта функция по существу походит на Файловый менеджер Mac OS PBFlushFile функция. Клиентская программа может вызвать эту функцию после любой операции записи (также DataHPutData или DataHWrite). Ваш компонент должен сделать то, что необходимо, чтобы удостовериться, что данные записаны в устройство хранения, содержащее текущую ссылку на данные.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHPlaybackHints
    DataHPlaybackHints

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHPlaybackHints ( DataHandler dh, long flags, unsigned long minFileOffset, unsigned long maxFileOffset, long bytesPerSecond );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`flags`	Зарезервированный. Установите этот параметр на 0.
`minFileOffset`	Вместе с `maxFileOffset` параметр, указывает диапазон данных, которые клиентская программа ожидает использовать от текущей ссылки на данные. Этот параметр указывает смещение самого раннего байта, который программа ожидает использовать (т.е. минимальное контейнерное значение смещения). Если клиент ожидает получать доступ к байтам с начала контейнера, оно должно установить этот параметр на 0.
`maxFileOffset`	Смещение последнего байта программа ожидает использовать (т.е. максимальное контейнерное значение смещения). Если клиент ожидает использовать байты всюду по контейнеру, клиент должен установить этот параметр на-1.
`bytesPerSecond`	Уровень в байтах в секунду, в которых Ваш обработчик данных должен считать данные из ссылки на данные, чтобы не отставать от ожидаемых потребностей программы клиента.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHTask
    DataHTask

(OS X v10.9)

Уступает процессорное время Вашему обработчику данных.

Объявление

Objective C

ComponentResult DataHTask ( DataHandler dh );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

Специальные замечания

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

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.

Чтение данных фильма


    
    DataHCloseForRead
    DataHCloseForRead

(OS X v10.9)

Доступ только для чтения завершений к его ссылке на данные.

Объявление

Objective C

ComponentResult DataHCloseForRead ( DataHandler dh );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Компоненты обработчика данных предоставляют две основных услуги чтения: DataHGetData функция является полностью синхронной операцией чтения, в то время как DataHScheduleData является асинхронным. Приложения предоставляют информацию планирования, когда они вызывают Ваш компонент DataHScheduleData функция. Когда Ваш компонент обрабатывает запрос с очередями, он вызывает функцию завершения обработчика данных приложения. Прежде чем любое приложение может считать данные из ссылки на данные, это должно открыть доступ для чтения к той ссылке путем вызова компонента DataHOpenForRead функция. DataHCloseForRead завершения тот путь доступа для чтения.

Специальные замечания

Обратите внимание на то, что клиентская программа может закрыть свое соединение с Вашим компонентом (путем вызова CloseComponent) не закрывая путь чтения. Если это происходит, Ваш компонент должен закрыть ссылку на данные прежде, чем закрыть соединение.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHFinishData
    DataHFinishData

(OS X v10.9)

Завершает или отменяет один или запросы чтения более с очередями.

Объявление

Objective C

ComponentResult DataHFinishData ( DataHandler dh, Ptr PlaceToPutDataPtr, Boolean Cancel );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`PlaceToPutDataPtr`	Расположение в памяти, которая должна получить данные. Значение этого параметра идентифицирует определенный запрос чтения, который будет завершен. Если этот параметр устанавливается на `NIL`, вызов влияет на все запросы чтения ожидания.
`Cancel`	Указывает, хочет ли программа вызова отменить выдающийся запрос. Если этот параметр устанавливается на ПРАВДА, Ваш обработчик данных должен отменить запрос (или запросы) идентифицированный `PlaceToPutDataPtr` параметр.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

Специальные замечания

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

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetAvailableFileSize
    DataHGetAvailableFileSize

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHGetAvailableFileSize ( DataHandler dh, long *fileSize );

Параметры

`dh`	Компонент обработчика данных.
`fileSize`	Указатель на размер файла.

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

Посмотрите Error Codes. Возвраты badComponentSelector если компонент обработчика данных не поддерживает этот вызов. Возвраты noErr если нет никакой ошибки.

Обсуждение

Можно вызвать эту функцию во время асинхронной операции чтения после вызова DataHScheduleData.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetData
    DataHGetData

(OS X v10.9)

Считывает данные из его текущей ссылки на данные, которая является синхронной операцией чтения.

Объявление

Objective C

ComponentResult DataHGetData ( DataHandler dh, Handle h, long hOffset, long offset, long size );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`h`	Дескриптор для получения данных.
`hOffset`	Идентифицирует смещение в дескриптор, куда Ваш компонент должен возвратить данные.
`offset`	Смещение в ссылке на данные, из которой должен читать Ваш компонент.
`size`	Число байтов для чтения.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Компоненты обработчика данных предоставляют две основных услуги чтения. DataHGetData функция является полностью синхронной операцией чтения, в то время как DataHScheduleData является асинхронным. (Приложения предоставляют информацию планирования, когда они вызывают DataHScheduleData.), Прежде чем любое приложение может считать данные из ссылки на данные, это должно открыть доступ для чтения к той ссылке путем вызова компонента DataHOpenForRead функция. DataHCloseForRead завершения тот путь доступа для чтения. Когда Ваш компонент обрабатывает запрос с очередями, он вызывает функцию завершения обработчика данных приложения.

Специальные замечания

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

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetFileSize
    DataHGetFileSize

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHGetFileSize ( DataHandler dh, long *fileSize );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`fileSize`	Указатель на длинное целое. Ваш компонент возвращает размер контейнера, соответствующего текущей ссылке на данные в байтах.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Эта функция оперативно эквивалентна Файловому менеджеру Mac OS GetEOF функция. Перед писанием данных к ссылке на данные приложения должны вызвать Ваш компонент DataHOpenForWrite функционируйте для открытия пути записи к контейнеру. DataHCloseForWrite завершения тот путь записи. Как имеет место с DataHScheduleData, когда Вы сделаны с запросом записи, Ваш компонент вызывает функцию завершения обработчика данных приложения.

Специальные замечания

Обратите внимание на то, что некоторые обработчики данных могут не поддерживать операции записи. Например, некоторые общие устройства, такие как CDROM «устройство автоматической смены дисков», могут быть устройствами только для чтения. В результате очень важно, чтобы Ваш обработчик данных правильно сообщил о своих возможностях записи клиентским программам.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetScheduleAheadTime
    DataHGetScheduleAheadTime

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHGetScheduleAheadTime ( DataHandler dh, long *millisecs );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`millisecs`	Указатель на длинное целое. Ваш компонент должен установить это поле со значением, указывающим число миллисекунд, Вы предпочитаете получать запросы чтения перед временем, когда должны быть поставлены данные.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Эта функция позволяет Вашему обработчику данных говорить клиентскую программу, как далеко заранее это должно запланировать свои запросы чтения. По умолчанию проблемы Панели инструментов Фильма запланировали запросы чтения между 1 и 2 секундами, прежде чем этому будут нужны данные от тех запросов. Для некоторых обработчиков данных, однако, это может не быть достаточным количеством времени. Например, некоторым обработчикам данных, вероятно, придется разместить сетевые задержки при обработке запросов чтения. Клиентские программы тот вызов DataHGetScheduleAheadTime может попытаться уважать предпочтение Вашего компонента.

Специальные замечания

Обратите внимание на то, что не все клиентские программы вызовут DataHGetScheduleAheadTime. Далее, некоторые клиенты могут не быть в состоянии разместить Ваше предпочтительное время во всех случаях, даже если они попросили предпочтение Вашего компонента. В результате Ваш компонент должен иметь стратегию того, чтобы обработать запросы, не обеспечивающие достаточно усовершенствованное время планирования. Например, если Ваш компонент получает a DataHScheduleData запросите, чтобы это не могло удовлетворить, это может привести запрос к сбою с надлежащим кодом ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHOpenForRead
    DataHOpenForRead

(OS X v10.9)

Открывает текущую ссылку на данные обработчика данных для доступа только для чтения.

Объявление

Objective C

ComponentResult DataHOpenForRead ( DataHandler dh );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

Специальные замечания

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHScheduleData
    DataHScheduleData

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHScheduleData ( DataHandler dh, Ptr PlaceToPutDataPtr, long FileOffset, long DataSize, long RefCon, DataHSchedulePtr scheduleRec, DataHCompletionUPP CompletionRtn );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`PlaceToPutDataPtr`	Расположение в памяти, которая должна получить данные.
`FileOffset`	Смещение в ссылке на данные, из которой должен читать Ваш компонент.
`DataSize`	Число байтов для чтения.
`RefCon`	Ссылочная константа, которую Ваш компонент обработчика данных должен обеспечить для функции завершения обработчика данных, указанной с `CompletionRtn` параметр.
`scheduleRec`	Указатель на a `DataHScheduleRecord`. Если этот параметр устанавливается на `NIL`, тогда клиентская программа запрашивает синхронную операцию чтения (т.е. Ваш обработчик данных должен возвратить данные перед возвращением управления к клиентской программе). Если этот параметр не устанавливается на `NIL`, это должно содержать расположение записи расписания, имеющей информацию синхронизации для асинхронного запроса чтения. Когда данные готовы, Ваш обработчик данных должен возвратить управление клиентской программе сразу, и затем вызвать функцию завершения обработчика данных клиента.
`CompletionRtn`	Указатель на функцию завершения обработчика данных, описанную в `DataHCompletionProc`. Клиентская программа должна обеспечить подпрограмму завершения для всех асинхронных запросов чтения (т.е. все запросы, включающие допустимую запись расписания). Для синхронных запросов клиентские программы должны установить этот параметр на `NIL`. Однако, если функция предоставлена, Ваш обработчик должен вызвать ее, даже после синхронных запросов. Когда Ваш обработчик данных заканчивается с клиентским запросом чтения программы, Ваш компонент должен вызвать эту подпрограмму, даже если запрос перестал работать. Ваш компонент должен передать ссылочную константу, которую клиентская программа предоставила `RefCon` параметр.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Эта функция обеспечивает и синхронное и асинхронный интерфейс чтения. Синхронные операции чтения работают как DataHGetData функция; компонент обработчика данных возвращает управление клиентской программе только после того, как это обслужило запрос чтения. Асинхронные операции чтения позволяют клиентским программам планировать запросы чтения в контексте указанной основы времени QuickTime. Ваш обработчик данных ставит запрос в очередь и сразу возвращает управление программе вызова. После того, как Ваш компонент фактически считывает данные, он вызывает клиентскую функцию завершения обработчика данных программы. Если Ваш компонент не может удовлетворить запрос (например, запрос требует данных более быстро, чем можно поставить его), компонент должен сразу отклонить запрос, вместо того, чтобы ставить запрос в очередь и затем вызвать функцию завершения обработчика данных клиента.

      typedef struct DataHScheduleRecord {
                    TimeRecord timeNeededBy; /* schedule info */
                    long     extendedID; /* type of data */
                    long     extendedVers; /* reserved */
                    Fixed   priority;  /* priority */
                    } DataHScheduleRecord, *DataHSchedulePtr;


  

Специальные замечания

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.

Выбор обработчика данных


    
    DataHCanUseDataRef
    DataHCanUseDataRef

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHCanUseDataRef ( DataHandler dh, Handle dataRef, long *useFlags );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`dataRef`	Ссылка на данные. Этот параметр содержит дескриптор к информации, идентифицирующей рассматриваемый контейнер.
`useFlags`	Указатель на поле флагов (см. ниже), что Ваше компонентное использование обработчика данных для указания его возможности получить доступ к контейнеру, идентифицированному `dataRef` параметр. Установите все надлежащие флаги в 1; установите неиспользованные флаги в 0. Например, если бы Ваши поддержки компонента объединили мультимедийные серверы в сеть с помощью специального набора протоколов, то обработчик данных должен установить `kDataHCanRead` и `kDataHCanSpecialRead` флаги к 1 для любого контейнера, который находится на том сервере. Кроме того, если Ваш компонент может записать в сервер, установите `kDataHCanWrite` и `kDataHCanSpecialWrite` флаги к 1 (возможно, вместе с `kDataHCanStreamingWrite`). Если Ваш обработчик данных не может получить доступ к контейнеру, установите целое поле в 0. Посмотрите эти константы: `kDataHCanRead` `kDataHSpecialRead` `kDataHSpecialReadFile` `kDataHCanWrite` `kDataHSpecialWrite` `kDataHCanStreamingWrite`

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Стандартный обработчик данных Apple устанавливает обоих kDataHCanRead и kDataHCanWrite флаги к 1 для любой ссылки на данные, которую это получает, указывая, что это может читать из и записать в любой объем.

Специальные замечания

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

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetDeviceIndex
    DataHGetDeviceIndex

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHGetDeviceIndex ( DataHandler dh, long *deviceIndex );

Параметры

dh

Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.


      deviceIndex

Указатель на поле, что Ваше компонентное использование обработчика данных для возврата значения идентификатора устройства. Ваш компонент может использовать любое значение идентификатора, которое является надлежащим (например, обработчик данных Apple HFS использует ссылочный номер объема). Клиентская программа должна сделать, ничто с этим значением кроме не сравнивает ее с другими идентификаторами, возвращенными Вашим компонентом обработчика данных.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetVolumeList
    DataHGetVolumeList

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHGetVolumeList ( DataHandler dh, DataHVolumeList *volumeList );

Параметры

dh

Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.


      volumeList

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

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Для сокращения задержки, которая может следовать из выбора надлежащего обработчика данных для объема Панель инструментов Фильма ведет список обработчиков данных и объемов, которые они поддерживают. Использование Панели инструментов Фильма DataHGetVolumeList создавать тот список. Ваш обработчик данных может использовать любые средства, необходимые, чтобы определить, может ли он получить доступ к объему, включая открытие контейнера на объеме. Ваш компонент должен установить в 1 столько флагов возможности, сколько являются подходящими для каждого объема. Не включайте записи для объемов, которые не может поддерживать Ваш обработчик. Например, если бы Ваши поддержки компонента объединили мультимедийные серверы в сеть с помощью специального набора протоколов, то обработчик данных должен установить kDataHCanRead и kDataHCanSpecialRead флаги к 1 для любого объема, который находится на том сервере. Кроме того, если Ваш компонент может записать в объем на сервере, установите kDataHCanWrite и kDataHCanSpecialWrite флаги к 1 (возможно, вместе с kDataHCanStreamingWrite). Однако Ваш компонент должен создать записи только для тех объемов, поддерживающих Ваши протоколы.

Специальные замечания

Это - ответственность программы вызова избавиться от дескриптора, возвращенного Вашим компонентом. Монтирование дорожек Панели инструментов Фильма и размонтирование съемных объемов, и держат свой список объема в курсе. В результате Панель инструментов Фильма может вызвать Ваш компонент DataHGetVolumeList функционируйте каждый раз, когда смонтирован съемный объем. Если Ваш обработчик данных не обрабатывает данные, которые сохранены в томах файловой системы, Вы не должны поддерживать эту функцию.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.

Используя ссылки на данные для доступа к носителям

DataHDeleteFile DataHDeleteFile (OS X v10.9)

Удаляет файл хранения данных обработчика данных.

Объявление

Objective C

ComponentResult DataHDeleteFile ( DataHandler dh );

Параметры

dh

Компонент обработчика данных.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.2 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.


    
    DataHGetInfo
    DataHGetInfo

(OS X v10.9)

Получает информацию от обработчика данных.

Объявление

Objective C

ComponentResult DataHGetInfo ( DataHandler dh, OSType what, void *info );

Параметры

`dh`	Компонент обработчика данных.
`what`	Селектор для требуемой информации. Никакие селекторы в настоящее время не определяются.
`info`	Указатель на область памяти, в которую можно поместить полученную информацию.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHSetMovieUsageFlags
    DataHSetMovieUsageFlags

(OS X v10.9)

Устанавливает способ, которым обработчик данных добавляет данные к своему хранению.

Объявление

Objective C

ComponentResult DataHSetMovieUsageFlags ( DataHandler dh, long flags );

Параметры

`dh`	Компонент обработчика данных.
`flags`	Константы (см. ниже), то добавление управляющей информации. Посмотрите эти константы: `kDataHMovieUsageDoAppendMDAT`

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.

Работа с неактивным менеджером


    
    DataHSetIdleManager
    DataHSetIdleManager

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHSetIdleManager ( DataHandler dh, IdleManager im );

Параметры

`dh`	Компонент обработчика данных.
`im`	Указатель на непрозрачную структуру данных, принадлежащую Mac OS Неактивный менеджер. Вы получаете этот указатель путем вызова `QTIdleManagerOpen`.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.

Запись данных фильма


    
    DataHCloseForWrite
    DataHCloseForWrite

(OS X v10.9)

Закрывает доступ только для записи к его ссылке на данные.

Объявление

Objective C

ComponentResult DataHCloseForWrite ( DataHandler dh );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Обработчики данных предоставляют две отличных услуги записи: DataHPutData простой синхронный интерфейс, позволяющий приложениям добавлять данные до конца контейнера, и DataHWrite более способная, асинхронная функция записи, подходящая для операций получения фильма. Перед писанием данных к ссылке на данные приложения должны вызвать Ваш компонент DataHOpenForWrite функционируйте для открытия пути записи к контейнеру. DataHCloseForWrite завершения тот путь записи. Как имеет место с DataHScheduleData, когда Вы сделаны с запросом записи, Ваш компонент вызывает функцию завершения обработчика данных приложения.

Специальные замечания

Клиентская программа может закрыть свое соединение с Вашим компонентом (путем вызова CloseComponent) не закрывая путь записи. Если это происходит, Ваш компонент должен закрыть ссылку на данные прежде, чем закрыть соединение. Обратите внимание на то, что некоторые обработчики данных могут не поддерживать операции записи. Например, некоторые общие устройства, такие как CDROM «устройство автоматической смены дисков», могут быть устройствами только для чтения. В результате очень важно, чтобы Ваш обработчик данных правильно сообщил о своих возможностях записи клиентским программам.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHCreateFile
    DataHCreateFile

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHCreateFile ( DataHandler dh, OSType creator, Boolean deleteExisting );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`creator`	Тип создателя нового контейнера. Если клиентская программа устанавливает этот параметр на 0, Ваш компонент должен выбрать рыночную стоимость (например, 'TV0D', `creator` введите для проигрывателя фильмов Apple).
`deleteExisting`	Указывает, удалить ли какие-либо существующие данные. Если этот параметр устанавливается на TRUE, и контейнер уже существует для текущей ссылки на данные, Ваш компонент должен удалить те данные прежде, чем создать новый контейнер. Если этот параметр устанавливается на FALSE, Ваш компонент должен сохранить любые данные, находящиеся в контейнере, определенном текущей ссылкой на данные (если существует кто-либо).

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

Специальные замечания

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetFreeSpace
    DataHGetFreeSpace

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHGetFreeSpace ( DataHandler dh, unsigned long *freeSize );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`freeSize`	Указатель на длинное целое без знака. Ваш компонент возвращает число байтов свободного пространства, доступного на устройстве, содержащем контейнер, именуемый текущей ссылкой на данные.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

Специальные замечания

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetPreferredBlockSize
    DataHGetPreferredBlockSize

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHGetPreferredBlockSize ( DataHandler dh, long *blockSize );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`blockSize`	Указатель на длинное целое. Ваш компонент возвращает размер блоков (в байтах), это предпочитает использовать при доступе к текущей ссылке на данные.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

Специальные замечания

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHOpenForWrite
    DataHOpenForWrite

(OS X v10.9)

Открывает текущую ссылку на данные Вашего компонента для доступа только для записи.

Объявление

Objective C

ComponentResult DataHOpenForWrite ( DataHandler dh );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

Специальные замечания

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHPreextend
    DataHPreextend

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHPreextend ( DataHandler dh, unsigned long maxToAdd, unsigned long *spaceAdded );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`maxToAdd`	Сумма пространства для добавления к текущей ссылке на данные, в байтах. Если клиентская программа устанавливает этот параметр на 0, Ваш компонент должен добавить столько пространства, сколько это может.
`spaceAdded`	Указатель на длинное целое без знака. Ваш компонент возвращает число байтов, которые это смогло добавить к ссылке на данные в байтах.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Эта функция просит, чтобы Ваш компонент сделал контейнер больше, аналогичным Файловому менеджеру Mac OS PBAllocContig функция. Когда это вызывают, Ваш компонент должен выделить непрерывную свободную площадь. Если нет достаточного непрерывного свободного пространства для удовлетворения запроса, компонент должен возвратить a dskFulErr код ошибки. Клиентские программы используют эту функцию во избежание несения любой задержки распределения пространства при получении данных фильма. Как имеет место с DataHScheduleData, когда Вы сделаны с запросом записи, Ваш компонент вызывает функцию завершения обработчика данных приложения.

Специальные замечания

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHPutData
    DataHPutData

(OS X v10.9)

Данные записей к текущей ссылке на данные компонента.

Объявление

Objective C

ComponentResult DataHPutData ( DataHandler dh, Handle h, long hOffset, long *offset, long size );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`h`	Дескриптор, содержащий данные, которые будут записаны в ссылку на данные.
`hOffset`	Идентифицирует смещение в дескриптор h к данным, которые будут записаны.
`offset`	Указатель на длинное целое. Ваш компонент возвращает смещение в ссылке на данные, в которой Ваш компонент записал данные.
`size`	Число байтов для записи.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

Специальные замечания

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHSetFileSize
    DataHSetFileSize

(OS X v10.9)

Устанавливает размер, в байтах, текущей ссылки на данные.

Объявление

Objective C

ComponentResult DataHSetFileSize ( DataHandler dh, long fileSize );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`fileSize`	Новый размер контейнера, соответствующего текущей ссылке на данные, в байтах.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

Специальные замечания

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHWrite
    DataHWrite

(OS X v10.9)

Данные записей к его текущей ссылке на данные.

Объявление

Objective C

ComponentResult DataHWrite ( DataHandler dh, Ptr data, long offset, long size, DataHCompletionUPP completion, long refCon );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`data`	Указывает указатель на данные, которые будут записаны. Клиентские программы должны заблокировать область памяти, содержащую эти данные, позволив Ваш компонент `DataHWrite` функционируйте для перемещения памяти.
`offset`	Смещение (в байтах) к расположению в текущей ссылке на данные, в которой можно записать данные.
`size`	Число байтов для записи.
`completion`	Указатель на функцию завершения обработчика данных, описанную в `DataHCompletionProc`. Клиентская программа должна обеспечить подпрограмму завершения для всех асинхронных запросов записи. Для синхронных запросов клиентские программы должны установить этот параметр на `NIL`. Когда Ваш обработчик данных заканчивается с клиентским запросом записи программы, Ваш компонент должен вызвать эту подпрограмму, даже если запрос перестал работать. Ваш компонент должен передать ссылочную константу, которую клиентская программа предоставила `refCon` параметр.
`refCon`	Ссылочная константа, которую Ваш компонент обработчика данных должен обеспечить для функции завершения обработчика данных, указанной с `completion` параметр. Для синхронных операций клиентские программы должны установить этот параметр на 0.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

Специальные замечания

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.

Поддержка функций


    
    DataCodecCompressPartial
    DataCodecCompressPartial

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult DataCodecCompressPartial ( DataCodecComponent dc, void **next_in, unsigned long *avail_in, unsigned long *total_in, void **next_out, unsigned long *avail_out, unsigned long *total_out, Boolean tryToFinish, Boolean *didFinish );

Параметры

`dc`	Компонент компрессора к используемому.
`next_in`	Недокументированный
`avail_in`	Недокументированный
`total_in`	Недокументированный
`next_out`	Недокументированный
`avail_out`	Недокументированный
`total_out`	Недокументированный
`tryToFinish`	Недокументированный
`didFinish`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataCodecDecompressPartial
    DataCodecDecompressPartial

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult DataCodecDecompressPartial ( DataCodecComponent dc, void **next_in, unsigned long *avail_in, unsigned long *total_in, void **next_out, unsigned long *avail_out, unsigned long *total_out, Boolean *didFinish );

Параметры

`dc`	Компонент декомпрессора к используемому.
`next_in`	Недокументированный
`avail_in`	Недокументированный
`total_in`	Недокументированный
`next_out`	Недокументированный
`avail_out`	Недокументированный
`total_out`	Недокументированный
`didFinish`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataCodecGetCompressBufferSize
    DataCodecGetCompressBufferSize

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataCodecGetCompressBufferSize ( DataCodecComponent dc, UInt32 srcSize, UInt32 *dstSize );

Параметры

`dc`	Компонент компрессора к используемому.
`srcSize`	Размер в байтах сжимаемых данных.
`dstSize`	Указатель на максимальный размер сжатых данных, которые будут возвращены.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Фактический размер сжатых данных, вероятно, будет меньшим, чем размер, который первоначально необходимо выделить, поэтому после сжатия данных, необходимо уменьшить сжатый дескриптор данных вниз к фактическому размеру данных. При сжатии фильма выделите дополнительные десять 32-разрядные целые числа пространства для хранения сжатой информации заголовка ресурса фильма, как показано в следующем примере кода:

      unsigned long compressedSize;
Handle compressedData;
DataCodecGetCompressBufferSize(dataCompressor, movieResourceSize, &compressedSize);
compressedData =NewHandle(compressedSize + (10 * sizeof(UInt32)));

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHAddMovie
    DataHAddMovie

(OS X v10.9)

Присваивает данные фильма обработчику данных.

Объявление

Objective C

ComponentResult DataHAddMovie ( DataHandler dh, Movie theMovie, short *id );

Параметры

`dh`	Компонент обработчика данных.
`theMovie`	Идентификатор фильма. Ваше приложение получает этот идентификатор из таких функций как `NewMovie`, `NewMovieFromFile`, и `NewMovieFromHandle`.
`id`	Указатель на поле, указывающее ресурс, содержащий данные фильма, которые должны быть добавлены.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHAppend64
    DataHAppend64

(OS X v10.9)

Добавляет данные к текущей ссылке на данные.

Объявление

Objective C

ComponentResult DataHAppend64 ( DataHandler dh, void *data, wide *fileOffset, unsigned long size );

Параметры

`dh`	Компонент обработчика данных.
`data`	Указатель на данные, которые будут добавлены.
`fileOffset`	Указатель на 64-разрядное значение, представляющее смещение в файле данных, которые будут добавлены.
`size`	Размер данных, которые будут добавлены.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHCreateFileWithFlags
    DataHCreateFileWithFlags

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult DataHCreateFileWithFlags ( DataHandler dh, OSType creator, Boolean deleteExisting, UInt32 flags );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`creator`	Тип создателя нового контейнера. Если клиентская программа устанавливает этот параметр на 0, Ваш компонент должен выбрать рыночную стоимость (например, 'TV0D', `creator` введите для проигрывателя фильмов Apple).
`deleteExisting`	Указывает, удалить ли какие-либо существующие данные. Если этот параметр устанавливается на TRUE, и контейнер уже существует для текущей ссылки на данные, Ваш компонент должен удалить те данные прежде, чем создать новый контейнер. Если этот параметр устанавливается на FALSE, Ваш компонент должен сохранить любые данные, находящиеся в контейнере, определенном текущей ссылкой на данные (если существует кто-либо).
`flags`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHDoesBuffer
    DataHDoesBuffer

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHDoesBuffer ( DataHandler dh, Boolean *buffersReads, Boolean *buffersWrites );

Параметры

`dh`	Компонент обработчика данных.
`buffersReads`	Указатель на булевскую переменную, которая является возвращенным true, если компонент обработчика данных действительно буферизует чтения, ложь иначе.
`buffersWrites`	Указатель на булевскую переменную, которая является возвращенным true, если компонент обработчика данных действительно буферизует записи, ложь иначе.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetCacheSizeLimit
    DataHGetCacheSizeLimit

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHGetCacheSizeLimit ( DataHandler dh, Size *cacheSizeLimit );

Параметры

`dh`	Компонент обработчика данных.
`cacheSizeLimit`	Указатель на предел размера кэша.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetDataAvailability
    DataHGetDataAvailability

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult DataHGetDataAvailability ( DataHandler dh, long offset, long len, long *missing_offset, long *missing_len );

Параметры

`dh`	Компонент обработчика данных.
`offset`	Недокументированный
`len`	Недокументированный
`missing_offset`	Недокументированный
`missing_len`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetDataInBuffer
    DataHGetDataInBuffer

(OS X v10.9)

Возвращает информацию о данных в буфере компонента обработчика данных.

Объявление

Objective C

ComponentResult DataHGetDataInBuffer ( DataHandler dh, long startOffset, long *size );

Параметры

`dh`	Компонент обработчика данных.
`startOffset`	Смещение к запуску данных.
`size`	Размер данных.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetDataRate
    DataHGetDataRate

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult DataHGetDataRate ( DataHandler dh, long flags, long *bytesPerSecond );

Параметры

`dh`	Компонент обработчика данных.
`flags`	Недокументированный
`bytesPerSecond`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetDataRefAsType
    DataHGetDataRefAsType

(OS X v10.9)

Получает текущую ссылку на данные компонента обработчика данных данного типа.

Объявление

Objective C

ComponentResult DataHGetDataRefAsType ( DataHandler dh, OSType requestedType, Handle *dataRef );

Параметры

`dh`	Компонент обработчика данных.
`requestedType`	Тип ссылки на данные для получения; посмотрите `Data References`.
`dataRef`	Указатель на дескриптор ссылки на данные. Ваш компонент должен сделать копию своей текущей ссылки на данные в дескрипторе и возврате, обрабатывающих в этом поле. Клиентская программа ответственна за избавление от того дескриптора. Различные типы контейнеров могут потребовать различных типов ссылок на данные. Например, в то время как ссылка на основанный на файле фильм может быть псевдонимом, ссылка на основанный на памяти фильм может быть дескриптором. Основанный на памяти обработчик данных Apple для Macintosh использует дескрипторы (и имеет значение подтипа `'hndl'`), в то время как менеджер по Псевдониму использования обработчика данных HFS искажает (его значение подтипа `'alis'`). Посмотрите `Data References`.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetDataRefExtension
    DataHGetDataRefExtension

(OS X v10.9)

Получает текущие данные расширения ссылки на данные Вашего компонента.

Объявление

Objective C

ComponentResult DataHGetDataRefExtension ( DataHandler dh, Handle *extension, OSType idType );

Параметры

`dh`	Компонент обработчика данных.
`extension`	Указатель на дескриптор к дополнительным данным.
`idType`	Четырехбайтовая подпись, идентифицирующая тип дополнительных данных.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetDataRefWithAnchor
    DataHGetDataRefWithAnchor

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHGetDataRefWithAnchor ( DataHandler dh, Handle anchorDataRef, OSType dataRefType, Handle *dataRef );

Параметры

`dh`	Компонент обработчика данных.
`anchorDataRef`	Дескриптор к ссылке на данные привязки.
`dataRefType`	Тип ссылки на данные; посмотрите `Data References`.
`dataRef`	Указатель на дескриптор ссылки на данные. Ваш компонент должен сделать копию своей текущей ссылки на данные в дескрипторе и возврате, обрабатывающих в этом поле. Клиентская программа ответственна за избавление от того дескриптора. Различные типы контейнеров могут потребовать различных типов ссылок на данные. Например, в то время как ссылка на основанный на файле фильм может быть псевдонимом, ссылка на основанный на памяти фильм может быть дескриптором. Основанный на памяти обработчик данных Apple для Macintosh использует дескрипторы (и имеет значение подтипа `'hndl'`), в то время как менеджер по Псевдониму использования обработчика данных HFS искажает (его значение подтипа `'alis'`). Посмотрите `Data References`.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetFileName
    DataHGetFileName

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHGetFileName ( DataHandler dh, Str255 str );

Параметры

`dh`	Компонент обработчика данных.
`str`	Имя файла как строка.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetFileSize64
    DataHGetFileSize64

(OS X v10.9)

Обеспечивает 64-разрядную версию DataHGetFileSize.

Объявление

Objective C

ComponentResult DataHGetFileSize64 ( DataHandler dh, wide *fileSize );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`fileSize`	Указатель на широкое. Ваш компонент возвращает размер контейнера, соответствующего текущей ссылке на данные в байтах.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Единственная разница между этой функцией и DataHGetFileSize это fileSize параметр является 64-разрядным целым числом вместо 32-разрядного целого числа.

Специальные замечания

Новые приложения должны использовать эту функцию вместо 32-разрядной версии.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetFileSizeAsync
    DataHGetFileSizeAsync

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHGetFileSizeAsync ( DataHandler dh, wide *fileSize, DataHCompletionUPP completionRtn, long refCon );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`fileSize`	Указатель на 64-разрядное значение. Ваш компонент возвращает размер контейнера, соответствующего текущей ссылке на данные в байтах.
`completionRtn`	Указатель на обратный вызов завершения обработчика данных, описанный в `DataHCompletionProc`.
`refCon`	Ссылочная константа, которая будет передана Вашему обратному вызову. Используйте этот параметр для указания на структуру данных, содержащую любую информацию функциональные потребности.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetFileTypeOrdering
    DataHGetFileTypeOrdering

(OS X v10.9)

Возвращает предпочтительное упорядочивание для получения информации о вводе файла.

Объявление

Objective C

ComponentResult DataHGetFileTypeOrdering ( DataHandler dh, DataHFileTypeOrderingHandle *orderingListHandle );

Параметры

dh

Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.


      orderingListHandle

Указатель на дескриптор к списку OSType значения (см. ниже). Список может содержать только подмножество в настоящее время определяемых типов (т.е. тип файла Mac OS, расширение, тип MIME) для ограничения рассмотрения разумными типами. Посмотрите эти константы:

kDataHFileTypeMacOSFileType
kDataHFileTypeExtension
kDataHFileTypeMIME

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

Специальные замечания

Прежде, чем позвонить к этой функции, клиент должен был открыть обработчик данных и вызвать DataHSetDataRef или DataHSetDataRefWithAnchor. Это позволяет обработчику данных возвращать различное упорядочивание на основе определенного файла. Это могло бы допускать обработчик данных для варьирования его упорядочивания на основе расположения файла. Например, на Mac OS, это могло бы использовать расширения только на чужих томах. Для других объемов это могло бы использовать тип файла Mac OS, сопровождаемый расширением файла.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetFreeSpace64
    DataHGetFreeSpace64

(OS X v10.9)

Обеспечивает 64-разрядную версию DataHGetFreeSpace.

Объявление

Objective C

ComponentResult DataHGetFreeSpace64 ( DataHandler dh, wide *freeSize );

Параметры

`dh`	Компонент обработчика данных.
`freeSize`	Указатель на 64-разрядное целое число. Ваш компонент возвращает число байтов свободного пространства, доступного на устройстве, содержащем контейнер, именуемый текущей ссылкой на данные.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Единственная разница между этой функцией и DataHGetFreeSpace это freeSize параметр является 64-разрядным целым числом вместо 32-разрядного целого числа.

Специальные замечания

Новые приложения должны использовать эту функцию вместо 32-разрядной версии.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetInfoFlags
    DataHGetInfoFlags

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHGetInfoFlags ( DataHandler dh, UInt32 *flags );

Параметры

`dh`	Компонент обработчика данных.
`flags`	Флаги (см. ниже), которые предоставляют информацию об обработчике данных. Посмотрите эти константы: `kDataHInfoFlagNeverStreams` `kDataHInfoFlagCanUpdateDataRefs` `kDataHInfoFlagNeedsNetworkBandwidth`

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetMacOSFileType
    DataHGetMacOSFileType

(OS X v10.9)

Получает тип файла Mac OS для текущей ссылки на данные обработчика данных.

Объявление

Objective C

ComponentResult DataHGetMacOSFileType ( DataHandler dh, OSType *fileType );

Параметры

`dh`	Компонент обработчика данных.
`fileType`	Указатель на тип файла; посмотрите `File Types and Creators`.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetMIMEType
    DataHGetMIMEType

(OS X v10.9)

Получает тип MIME для текущей ссылки на данные обработчика данных.

Объявление

Objective C

ComponentResult DataHGetMIMEType ( DataHandler dh, Str255 mimeType );

Параметры

`dh`	Компонент обработчика данных.
`mimeType`	MIME вводит строку.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetMIMETypeAsync
    DataHGetMIMETypeAsync

(OS X v10.9)

Выполняет асинхронное открытие HTTP/СОЕЕИНЕНИЯ FTP тип MIME.

Объявление

Objective C

ComponentResult DataHGetMIMETypeAsync ( DataHandler dh, Str255 mimeType, DataHCompletionUPP completionRtn, long refCon );

Параметры

`dh`	Компонент обработчика данных.
`mimeType`	MIME вводит строку, когда (и если) это становится доступным.
`completionRtn`	A `DataHCompletionProc` обратный вызов, который вызывают, когда или данные становятся доступными или существует отказ. Если существует тайм-аут или, отказ может произойти `DataHFinishData` вызывается с инструкцией отмены. `mimeType` параметр не будет обновлен, пока полная подпрограмма не выполняется. Если подпрограмма завершения не будет указана, то вызов сразу возвратится.
`refCon`	Ссылочная константа, которая будет передана Вашему обратному вызову. Используйте этот параметр для указания на структуру данных, содержащую любую информацию функциональные потребности.

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

Если тип MIME известен, эта функция обновления mimeType и возвраты noErr. Если информация еще не известна, ошибка notEnoughDataErr возвращается. Это позволяет неблокировать вызовы, которые будут сделаны к этой функции. Если это возвращает другую ошибку, указывающую некоторый другой отказ; посмотрите Error Codes.

Обсуждение

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

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetMovie
    DataHGetMovie

(OS X v10.9)

Получает фильм для текущей ссылки на данные обработчика данных.

Объявление

Objective C

ComponentResult DataHGetMovie ( DataHandler dh, Movie *theMovie, short *id );

Параметры

`dh`	Компонент обработчика данных.
`theMovie`	Идентификатор фильма. Это совпадает с идентификатором, который Ваше приложение получает из таких функций как `NewMovie`, `NewMovieFromFile`, и `NewMovieFromHandle`.
`id`	Указатель на поле, указывающее ресурс, содержащий данные фильма.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetMovieWithFlags
    DataHGetMovieWithFlags

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHGetMovieWithFlags ( DataHandler dh, Movie *theMovie, short *id, short flags );

Параметры

`dh`	Компонент обработчика данных.
`theMovie`	Идентификатор фильма. Это совпадает с идентификатором, который Ваше приложение получает из таких функций как `NewMovie`, `NewMovieFromFile`, и `NewMovieFromHandle`.
`id`	Указатель на поле, указывающее ресурс, содержащий данные фильма.
`flags`	Флаги (см. ниже), тот фильм управления характеристики. Посмотрите эти константы: `newMovieActive` `newMovieDontResolveDataRefs` `newMovieDontAskUnresolvedDataRefs`

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

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

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHGetTemporaryDataRefCapabilities
    DataHGetTemporaryDataRefCapabilities

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult DataHGetTemporaryDataRefCapabilities ( DataHandler dh, long *outUnderstoodFlags );

Параметры

`dh`	Компонент обработчика данных.
`outUnderstoodFlags`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHIsStreamingDataHandler
    DataHIsStreamingDataHandler

(OS X v10.9)

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

Объявление

Objective C

ComponentResult DataHIsStreamingDataHandler ( DataHandler dh, Boolean *yes );

Параметры

`dh`	Компонент обработчика данных.
`yes`	Указатель на булевскую переменную, возвращающую TRUE, если обработчик данных обрабатывает данные потоковой передачи, FALSE иначе.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHPlaybackHints64
    DataHPlaybackHints64

(OS X v10.9)

Обеспечивает 64-разрядную версию DataHPlaybackHints.

Объявление

Objective C

ComponentResult DataHPlaybackHints64 ( DataHandler dh, long flags, const wide *minFileOffset, const wide *maxFileOffset, long bytesPerSecond );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`flags`	Зарезервированный. Установите этот параметр на 0.
`minFileOffset`	Вместе с `maxFileOffset` параметр, указывает диапазон данных, которые клиентская программа ожидает использовать от текущей ссылки на данные. Этот параметр указывает на смещение самого раннего байта, который программа ожидает использовать (т.е. минимальное контейнерное значение смещения). Если клиент ожидает получать доступ к байтам с начала контейнера, оно должно установить этот параметр на 0.
`maxFileOffset`	Указатель на смещение последнего байта программа ожидает использовать (т.е. максимальное контейнерное значение смещения). Если клиент ожидает использовать байты всюду по контейнеру, клиент должен установить этот параметр на-1.
`bytesPerSecond`	Уровень в байтах в секунду, в которых Ваш обработчик данных должен считать данные из ссылки на данные, чтобы не отставать от ожидаемых потребностей программы клиента.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Единственная разница между этой функцией и DataHPlaybackHints это minFileOffset параметр и maxFileOffset параметр является 64-разрядными целыми числами вместо 32-разрядных целых чисел.

Специальные замечания

Новые приложения должны использовать эту функцию вместо 32-разрядной версии.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHPollRead
    DataHPollRead

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult DataHPollRead ( DataHandler dh, void *dataPtr, UInt32 *dataSizeSoFar );

Параметры

`dh`	Компонент обработчика данных.
`dataPtr`	Недокументированный
`dataSizeSoFar`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHPreextend64
    DataHPreextend64

(OS X v10.9)

Обеспечивает 64-разрядную версию DataHPreextend.

Объявление

Objective C

ComponentResult DataHPreextend64 ( DataHandler dh, const wide *maxToAdd, wide *spaceAdded );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`maxToAdd`	Сумма пространства для добавления к текущей ссылке на данные, в байтах. Если клиентская программа устанавливает этот параметр на 0, Ваш компонент должен добавить столько пространства, сколько это может.
`spaceAdded`	Указатель на 64-разрядное целое число. Ваш компонент возвращает число байтов, которые это смогло добавить к ссылке на данные в байтах.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Единственная разница между этой функцией и DataHPreextend это spaceAdded параметр является 64-разрядным целым числом вместо 32-разрядного целого числа.

Специальные замечания

Новые приложения должны использовать эту функцию вместо 32-разрядной версии.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHReadAsync
    DataHReadAsync

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult DataHReadAsync ( DataHandler dh, void *dataPtr, UInt32 dataSize, const wide *dataOffset, DataHCompletionUPP completion, long refCon );

Параметры

`dh`	Компонент обработчика данных.
`dataPtr`	Недокументированный
`dataSize`	Недокументированный
`dataOffset`	Недокументированный
`completion`	Указатель на обратный вызов завершения обработчика данных, описанный в `DataHCompletionProc`.
`refCon`	Ссылочная константа, которая будет передана Вашему обратному вызову. Используйте этот параметр для указания на структуру данных, содержащую любую информацию функциональные потребности.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHRenameFile
    DataHRenameFile

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult DataHRenameFile ( DataHandler dh, Handle newDataRef );

Параметры

`dh`	Компонент обработчика данных.
`newDataRef`	Дескриптор к новой ссылке на данные QuickTime.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHScheduleData64
    DataHScheduleData64

(OS X v10.9)

Обеспечивает 64-разрядную версию DataHScheduleData.

Объявление

Objective C

ComponentResult DataHScheduleData64 ( DataHandler dh, Ptr PlaceToPutDataPtr, const wide *FileOffset, long DataSize, long RefCon, DataHSchedulePtr scheduleRec, DataHCompletionUPP CompletionRtn );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`PlaceToPutDataPtr`	Расположение в памяти, которая должна получить данные.
`FileOffset`	Указатель на смещение в ссылке на данные, из которой должен читать Ваш компонент.
`DataSize`	Число байтов для чтения.
`RefCon`	Ссылочная константа, которую Ваш компонент обработчика данных должен обеспечить для функции завершения обработчика данных, указанной с `CompletionRtn` параметр.
`scheduleRec`	Указатель на a `DataHScheduleRecord`. Если этот параметр устанавливается на `NIL`, тогда клиентская программа запрашивает синхронную операцию чтения (т.е. Ваш обработчик данных должен возвратить данные перед возвращением управления к клиентской программе). Если этот параметр не устанавливается на `NIL`, это должно содержать расположение записи расписания, имеющей информацию синхронизации для асинхронного запроса чтения. Когда данные готовы, Ваш обработчик данных должен возвратить управление клиентской программе сразу, и затем вызвать функцию завершения обработчика данных клиента.
`CompletionRtn`	Указатель на функцию завершения обработчика данных, описанную в `DataHCompletionProc`. Клиентская программа должна обеспечить подпрограмму завершения для всех асинхронных запросов чтения (т.е. все запросы, включающие допустимую запись расписания). Для синхронных запросов клиентские программы должны установить этот параметр на `NIL`. Однако, если функция предоставлена, Ваш обработчик должен вызвать ее, даже после синхронных запросов. Когда Ваш обработчик данных заканчивается с клиентским запросом чтения программы, Ваш компонент должен вызвать эту подпрограмму, даже если запрос перестал работать. Ваш компонент должен передать ссылочную константу, которую клиентская программа предоставила `RefCon` параметр.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Единственная разница между этой функцией и DataHScheduleData это FileOffset параметр является 64-разрядным целым числом вместо 32-разрядного целого числа.

Специальные замечания

Новые приложения должны использовать эту функцию вместо 32-разрядной версии.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHSetCacheSizeLimit
    DataHSetCacheSizeLimit

(OS X v10.9)

Устанавливает предел размера кэша для компонента обработчика данных.

Объявление

Objective C

ComponentResult DataHSetCacheSizeLimit ( DataHandler dh, Size cacheSizeLimit );

Параметры

`dh`	Компонент обработчика данных.
`cacheSizeLimit`	Указатель на предел размера кэша.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHSetDataRefExtension
    DataHSetDataRefExtension

(OS X v10.9)

Устанавливает текущие данные расширения ссылки на данные Вашего компонента.

Объявление

Objective C

ComponentResult DataHSetDataRefExtension ( DataHandler dh, Handle extension, OSType idType );

Параметры

`dh`	Компонент обработчика данных.
`extension`	Дескриптор к дополнительным данным.
`idType`	Четырехбайтовая подпись, идентифицирующая тип дополнительных данных.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHSetDataRefWithAnchor
    DataHSetDataRefWithAnchor

(OS X v10.9)

Устанавливает ссылку на данные и ссылку на данные привязки для обработчика данных.

Объявление

Objective C

ComponentResult DataHSetDataRefWithAnchor ( DataHandler dh, Handle anchorDataRef, OSType dataRefType, Handle dataRef );

Параметры

`dh`	Компонент обработчика данных.
`anchorDataRef`	Дескриптор к ссылке на данные привязки.
`dataRefType`	Тип ссылки на данные. Различные типы контейнеров могут потребовать различных типов ссылок на данные. Например, в то время как ссылка на основанный на файле фильм может быть псевдонимом, ссылка на основанный на памяти фильм может быть дескриптором. Основанный на памяти обработчик данных Apple для Macintosh использует дескрипторы (и имеет значение подтипа `'hndl'`), в то время как менеджер по Псевдониму использования обработчика данных HFS искажает (его значение подтипа `'alis'`). Посмотрите `Data References`.
`dataRef`	Дескриптор ссылки на данные. Ваш компонент должен сделать копию своей текущей ссылки на данные в дескрипторе и возврате, обрабатывающих в этом поле. Клиентская программа ответственна за избавление от того дескриптора.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHSetFileSize64
    DataHSetFileSize64

(OS X v10.9)

Обеспечивает 64-разрядную версию DataHSetFileSize.

Объявление

Objective C

ComponentResult DataHSetFileSize64 ( DataHandler dh, const wide *fileSize );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`fileSize`	Указатель на новый размер контейнера, соответствующего текущей ссылке на данные, в байтах.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Единственная разница между этой функцией и DataHSetFileSize это fileSize параметр является 64-разрядным целым числом вместо 32-разрядного целого числа.

Специальные замечания

Новые приложения должны использовать эту функцию вместо 32-разрядной версии.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHSetMacOSFileType
    DataHSetMacOSFileType

(OS X v10.9)

Устанавливает тип файла Mac OS для текущей ссылки на данные обработчика данных.

Объявление

Objective C

ComponentResult DataHSetMacOSFileType ( DataHandler dh, OSType fileType );

Параметры

`dh`	Компонент обработчика данных.
`fileType`	Тип файла; посмотрите `File Types and Creators`.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHSetTimeBase
    DataHSetTimeBase

(OS X v10.9)

Устанавливает основу времени для компонента обработчика данных.

Объявление

Objective C

ComponentResult DataHSetTimeBase ( DataHandler dh, TimeBase tb );

Параметры

`dh`	Компонент обработчика данных.
`tb`	Указатель на a `TimeBaseRecord` структура.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHSetTimeHints
    DataHSetTimeHints

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult DataHSetTimeHints ( DataHandler dh, long flags, long bandwidthPriority, TimeScale scale, TimeValue minTime, TimeValue maxTime );

Параметры

`dh`	Компонент обработчика данных.
`flags`	Недокументированный
`bandwidthPriority`	Недокументированный
`scale`	Недокументированный
`minTime`	Недокументированный
`maxTime`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHUpdateMovie
    DataHUpdateMovie

(OS X v10.9)

Обновляет фильм для текущей ссылки на данные обработчика данных.

Объявление

Objective C

ComponentResult DataHUpdateMovie ( DataHandler dh, Movie theMovie, short id );

Параметры

`dh`	Компонент обработчика данных.
`theMovie`	Идентификатор фильма. Ваше приложение получает этот идентификатор из таких функций как `NewMovie`, `NewMovieFromFile`, и `NewMovieFromHandle`.
`id`	Указывает ресурс, содержащий данные фильма.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHUseTemporaryDataRef
    DataHUseTemporaryDataRef

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult DataHUseTemporaryDataRef ( DataHandler dh, long inFlags );

Параметры

`dh`	Компонент обработчика данных.
`inFlags`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    DataHWrite64
    DataHWrite64

(OS X v10.9)

Обеспечивает 64-разрядную версию DataHWrite.

Объявление

Objective C

ComponentResult DataHWrite64 ( DataHandler dh, Ptr data, const wide *offset, long size, DataHCompletionUPP completion, long refCon );

Параметры

`dh`	Идентифицирует соединение программы вызова с Вашим компонентом обработчика данных.
`data`	Указывает указатель на данные, которые будут записаны. Клиентские программы должны заблокировать область памяти, содержащую эти данные, позволив Ваш компонент `DataHWrite` функционируйте для перемещения памяти.
`offset`	Указатель на смещение (в байтах) расположения в текущей ссылке на данные, в которой можно записать данные.
`size`	Число байтов для записи.
`completion`	Указатель на функцию завершения обработчика данных, описанную в `DataHCompletionProc`. Клиентская программа должна обеспечить подпрограмму завершения для всех асинхронных запросов записи. Для синхронных запросов клиентские программы должны установить этот параметр на `NIL`. Когда Ваш обработчик данных заканчивается с клиентским запросом записи программы, Ваш компонент должен вызвать эту подпрограмму, даже если запрос перестал работать. Ваш компонент должен передать ссылочную константу, которую клиентская программа предоставила `refCon` параметр.
`refCon`	Ссылочная константа, которую Ваш компонент обработчика данных должен обеспечить для функции завершения обработчика данных, указанной с `completion` параметр. Для синхронных операций клиентские программы должны установить этот параметр на 0.

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

Обсуждение

Единственная разница между этой функцией и DataHWrite это offset параметр является 64-разрядным целым числом вместо 32-разрядного целого числа.

Специальные замечания

Новые приложения должны использовать эту функцию вместо 32-разрядной версии.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.

DisposeCDataHandlerUPP DisposeCDataHandlerUPP (OS X v10.9)

Избавляется от указателя CDataHandlerUPP.

Объявление

Objective C

void DisposeCDataHandlerUPP ( CDataHandlerUPP userUPP );

Параметры

userUPP

A CDataHandlerUPP указатель. Посмотрите Universal Procedure Pointers.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.2 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
DisposeCharDataHandlerUPP DisposeCharDataHandlerUPP (OS X v10.9)

Избавляется от указателя CharDataHandlerUPP.

Объявление

Objective C

void DisposeCharDataHandlerUPP ( CharDataHandlerUPP userUPP );

Параметры

userUPP

A CharDataHandlerUPP указатель.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
DisposeCommentHandlerUPP DisposeCommentHandlerUPP (OS X v10.9)

Избавляется от указателя CommentHandlerUPP.

Объявление

Objective C

void DisposeCommentHandlerUPP ( CommentHandlerUPP userUPP );

Параметры

userUPP

A CommentHandlerUPP указатель.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
DisposeDataHCompletionUPP DisposeDataHCompletionUPP (OS X v10.9)

Избавляется от указателя DataHCompletionUPP.

Объявление

Objective C

void DisposeDataHCompletionUPP ( DataHCompletionUPP userUPP );

Параметры

userUPP

A DataHCompletionUPP указатель. Посмотрите Universal Procedure Pointers.

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

Можно получить доступ к ошибочным возвратам этой функции через GetMoviesError и GetMoviesStickyError.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
DisposeEndDocumentHandlerUPP DisposeEndDocumentHandlerUPP (OS X v10.9)

Избавляется от указателя EndDocumentHandlerUPP.

Объявление

Objective C

void DisposeEndDocumentHandlerUPP ( EndDocumentHandlerUPP userUPP );

Параметры

userUPP

EndDocumentHandlerUPP указатель.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
DisposeEndElementHandlerUPP DisposeEndElementHandlerUPP (OS X v10.9)

Избавляется от указателя EndElementHandlerUPP.

Объявление

Objective C

void DisposeEndElementHandlerUPP ( EndElementHandlerUPP userUPP );

Параметры

userUPP

EndElementHandlerUPP указатель.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
DisposePreprocessInstructionHandlerUPP DisposePreprocessInstructionHandlerUPP (OS X v10.9)

Избавляется от указателя PreprocessInstructionHandlerUPP.

Объявление

Objective C

void DisposePreprocessInstructionHandlerUPP ( PreprocessInstructionHandlerUPP userUPP );

Параметры

userUPP

A PreprocessInstructionHandlerUPP указатель.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
DisposeStartDocumentHandlerUPP DisposeStartDocumentHandlerUPP (OS X v10.9)

Избавляется от указателя StartDocumentHandlerUPP.

Объявление

Objective C

void DisposeStartDocumentHandlerUPP ( StartDocumentHandlerUPP userUPP );

Параметры

userUPP

A StartDocumentHandlerUPP указатель.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
DisposeStartElementHandlerUPP DisposeStartElementHandlerUPP (OS X v10.9)

Избавляется от указателя StartElementHandlerUPP.

Объявление

Objective C

void DisposeStartElementHandlerUPP ( StartElementHandlerUPP userUPP );

Параметры

userUPP

A StartElementHandlerUPP указатель.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
DisposeVdigIntUPP DisposeVdigIntUPP (OS X v10.9)

Избавляется от указателя VdigIntUPP.

Объявление

Objective C

void DisposeVdigIntUPP ( VdigIntUPP userUPP );

Параметры

userUPP

A VdigIntUPP указатель. Посмотрите Universal Procedure Pointers.

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

Можно получить доступ к ошибочным возвратам этой функции через GetMoviesError и GetMoviesStickyError.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
NewCDataHandlerUPP NewCDataHandlerUPP (OS X v10.9)

Выделяет Универсальный Указатель Процедуры для обратного вызова CDataHandlerProc.

Объявление

Objective C

CDataHandlerUPP NewCDataHandlerUPP ( CDataHandler userRoutine );

Параметры

userRoutine

Недокументированный

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

Новый UPP; посмотрите Universal Procedure Pointers.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.2 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
NewCharDataHandlerUPP NewCharDataHandlerUPP (OS X v10.9)

Недокументированный

Объявление

Objective C

CharDataHandlerUPP NewCharDataHandlerUPP ( CharDataHandler userRoutine );

Параметры

userRoutine

Недокументированный

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

Новый UPP; посмотрите Universal Procedure Pointers.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
NewCommentHandlerUPP NewCommentHandlerUPP (OS X v10.9)

Недокументированный

Объявление

Objective C

CommentHandlerUPP NewCommentHandlerUPP ( CommentHandler userRoutine );

Параметры

userRoutine

Недокументированный

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

Новый UPP; посмотрите Universal Procedure Pointers.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
NewDataHCompletionUPP NewDataHCompletionUPP (OS X v10.9)

Выделяет Универсальный Указатель Процедуры для обратного вызова DataHCompletionProc.

Объявление

Objective C

DataHCompletionUPP NewDataHCompletionUPP ( DataHCompletionProcPtr userRoutine );

Параметры

userRoutine

Указатель на Вашу определенную с помощью приложения функцию.

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

Новый UPP; посмотрите Universal Procedure Pointers.

Обсуждение

Эта функция используется с системами PowerPC Macintosh. Посмотрите Внутренний Macintosh: Системное программное обеспечение PowerPC.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
NewEndDocumentHandlerUPP NewEndDocumentHandlerUPP (OS X v10.9)

Недокументированный

Объявление

Objective C

EndDocumentHandlerUPP NewEndDocumentHandlerUPP ( EndDocumentHandler userRoutine );

Параметры

userRoutine

Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
NewEndElementHandlerUPP NewEndElementHandlerUPP (OS X v10.9)

Недокументированный

Объявление

Objective C

EndElementHandlerUPP NewEndElementHandlerUPP ( EndElementHandler userRoutine );

Параметры

userRoutine

Недокументированный

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

Новый UPP; посмотрите Universal Procedure Pointers.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
NewPreprocessInstructionHandlerUPP NewPreprocessInstructionHandlerUPP (OS X v10.9)

Недокументированный

Объявление

Objective C

PreprocessInstructionHandlerUPP NewPreprocessInstructionHandlerUPP ( PreprocessInstructionHandler userRoutine );

Параметры

userRoutine

Недокументированный

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

Новый UPP; посмотрите Universal Procedure Pointers.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
NewStartDocumentHandlerUPP NewStartDocumentHandlerUPP (OS X v10.9)

Недокументированный

Объявление

Objective C

StartDocumentHandlerUPP NewStartDocumentHandlerUPP ( StartDocumentHandler userRoutine );

Параметры

userRoutine

Недокументированный

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

Новый UPP; посмотрите Universal Procedure Pointers.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
NewStartElementHandlerUPP NewStartElementHandlerUPP (OS X v10.9)

Недокументированный

Объявление

Objective C

StartElementHandlerUPP NewStartElementHandlerUPP ( StartElementHandler userRoutine );

Параметры

userRoutine

Недокументированный

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

Новый UPP; посмотрите Universal Procedure Pointers.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.
NewVdigIntUPP NewVdigIntUPP (OS X v10.9)

Выделяет Универсальный Указатель Процедуры для обратного вызова VdigIntProc.

Объявление

Objective C

VdigIntUPP NewVdigIntUPP ( VdigIntProcPtr userRoutine );

Параметры

userRoutine

Указатель на Вашу определенную с помощью приложения функцию.

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

Новый UPP; посмотрите Universal Procedure Pointers.

Обсуждение

Эта функция используется с системами PowerPC Macintosh. Посмотрите Внутренний Macintosh: Системное программное обеспечение PowerPC.

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
Не доступный 64-разрядным приложениям.


    
    XMLParseAddAttribute
    XMLParseAddAttribute

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseAddAttribute ( ComponentInstance aParser, UInt32 elementID, UInt32 nameSpaceID, char *attributeName, UInt32 *attributeID );

Параметры

`aParser`	Недокументированный
`elementID`	Недокументированный
`nameSpaceID`	Недокументированный
`attributeName`	Недокументированный
`attributeID`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseAddAttributeAndValue
    XMLParseAddAttributeAndValue

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseAddAttributeAndValue ( ComponentInstance aParser, UInt32 elementID, UInt32 nameSpaceID, char *attributeName, UInt32 *attributeID, UInt32 attributeValueKind, void *attributeValueKindInfo );

Параметры

`aParser`	Недокументированный
`elementID`	Недокументированный
`nameSpaceID`	Недокументированный
`attributeName`	Недокументированный
`attributeID`	Недокументированный
`attributeValueKind`	Недокументированный
`attributeValueKindInfo`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseAddAttributeValueKind
    XMLParseAddAttributeValueKind

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseAddAttributeValueKind ( ComponentInstance aParser, UInt32 elementID, UInt32 attributeID, UInt32 attributeValueKind, void *attributeValueKindInfo );

Параметры

`aParser`	Недокументированный
`elementID`	Недокументированный
`attributeID`	Недокументированный
`attributeValueKind`	Недокументированный
`attributeValueKindInfo`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseAddElement
    XMLParseAddElement

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseAddElement ( ComponentInstance aParser, char *elementName, UInt32 nameSpaceID, UInt32 *elementID, long elementFlags );

Параметры

`aParser`	Недокументированный
`elementName`	Недокументированный
`nameSpaceID`	Недокументированный
`elementID`	Недокументированный
`elementFlags`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseAddMultipleAttributes
    XMLParseAddMultipleAttributes

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseAddMultipleAttributes ( ComponentInstance aParser, UInt32 elementID, UInt32 *nameSpaceIDs, char *attributeNames, UInt32 *attributeIDs );

Параметры

`aParser`	Недокументированный
`elementID`	Недокументированный
`nameSpaceIDs`	Недокументированный
`attributeNames`	Недокументированный
`attributeIDs`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseAddMultipleAttributesAndValues
    XMLParseAddMultipleAttributesAndValues

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseAddMultipleAttributesAndValues ( ComponentInstance aParser, UInt32 elementID, UInt32 *nameSpaceIDs, char *attributeNames, UInt32 *attributeIDs, UInt32 *attributeValueKinds, void **attributeValueKindInfos );

Параметры

`aParser`	Недокументированный
`elementID`	Недокументированный
`nameSpaceIDs`	Недокументированный
`attributeNames`	Недокументированный
`attributeIDs`	Недокументированный
`attributeValueKinds`	Недокументированный
`attributeValueKindInfos`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseAddNameSpace
    XMLParseAddNameSpace

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseAddNameSpace ( ComponentInstance aParser, char *nameSpaceURL, UInt32 *nameSpaceID );

Параметры

`aParser`	Недокументированный
`nameSpaceURL`	Недокументированный
`nameSpaceID`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseDataRef
    XMLParseDataRef

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseDataRef ( ComponentInstance aParser, Handle dataRef, OSType dataRefType, long parseFlags, XMLDoc *document );

Параметры

`aParser`	Недокументированный
`dataRef`	Недокументированный
`dataRefType`	Недокументированный
`parseFlags`	Недокументированный
`document`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseDisposeXMLDoc
    XMLParseDisposeXMLDoc

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseDisposeXMLDoc ( ComponentInstance aParser, XMLDoc document );

Параметры

`aParser`	Недокументированный
`document`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseFile
    XMLParseFile

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseFile ( ComponentInstance aParser, ConstFSSpecPtr fileSpec, long parseFlags, XMLDoc *document );

Параметры

`aParser`	Недокументированный
`fileSpec`	Недокументированный
`parseFlags`	Недокументированный
`document`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseGetDetailedParseError
    XMLParseGetDetailedParseError

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseGetDetailedParseError ( ComponentInstance aParser, long *errorLine, StringPtr errDesc );

Параметры

`aParser`	Недокументированный
`errorLine`	Недокументированный
`errDesc`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseSetCDataHandler
    XMLParseSetCDataHandler

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseSetCDataHandler ( ComponentInstance aParser, CDataHandlerUPP cdata );

Параметры

`aParser`	Недокументированный
`cdata`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseSetCharDataHandler
    XMLParseSetCharDataHandler

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseSetCharDataHandler ( ComponentInstance aParser, CharDataHandlerUPP charData );

Параметры

`aParser`	Недокументированный
`charData`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseSetCommentHandler
    XMLParseSetCommentHandler

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseSetCommentHandler ( ComponentInstance aParser, CommentHandlerUPP comment );

Параметры

`aParser`	Недокументированный
`comment`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseSetEndDocumentHandler
    XMLParseSetEndDocumentHandler

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseSetEndDocumentHandler ( ComponentInstance aParser, EndDocumentHandlerUPP endDocument );

Параметры

`aParser`	Недокументированный
`endDocument`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseSetEndElementHandler
    XMLParseSetEndElementHandler

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseSetEndElementHandler ( ComponentInstance aParser, EndElementHandlerUPP endElement );

Параметры

`aParser`	Недокументированный
`endElement`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseSetEventParseRefCon
    XMLParseSetEventParseRefCon

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseSetEventParseRefCon ( ComponentInstance aParser, long refcon );

Параметры

`aParser`	Недокументированный
`refcon`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseSetOffsetAndLimit
    XMLParseSetOffsetAndLimit

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseSetOffsetAndLimit ( ComponentInstance aParser, UInt32 offset, UInt32 limit );

Параметры

`aParser`	Недокументированный
`offset`	Недокументированный
`limit`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseSetPreprocessInstructionHandler
    XMLParseSetPreprocessInstructionHandler

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseSetPreprocessInstructionHandler ( ComponentInstance aParser, PreprocessInstructionHandlerUPP preprocessInstruction );

Параметры

`aParser`	Недокументированный
`preprocessInstruction`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseSetStartDocumentHandler
    XMLParseSetStartDocumentHandler

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseSetStartDocumentHandler ( ComponentInstance aParser, StartDocumentHandlerUPP startDocument );

Параметры

`aParser`	Недокументированный
`startDocument`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.


    
    XMLParseSetStartElementHandler
    XMLParseSetStartElementHandler

(OS X v10.9)

Недокументированный

Объявление

Objective C

ComponentResult XMLParseSetStartElementHandler ( ComponentInstance aParser, StartElementHandlerUPP startElement );

Параметры

`aParser`	Недокументированный
`startElement`	Недокументированный

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

Посмотрите Error Codes. Возвраты noErr если нет никакой ошибки.

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

Objective C

@import QuickTime;

Доступность

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

Осуждаемый в OS X v10.9.

Не доступный 64-разрядным приложениям.

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

Разные компонентные обратные вызовы данных


    
    DataHCompletionProc
    DataHCompletionProc

Призванный завершение операции чтения или операции записи.

Объявление

Objective C

typedef void (*DataHCompletionProcPtr) ( Ptr request, long refcon, OSErr err);

Параметры

`request`	Указывает указатель на данные, связанные с запросом чтения `DataHScheduleData` или запишите запрос `DataHWrite`. Клиентская программа использует этот указатель для определения, какой запрос завершился.
`refcon`	Ссылочная константа, что клиентская программа, предоставленная Вашему компоненту обработчика данных, когда это выполнило исходный запрос.
`err`	Указывает успешность или неуспешность работы. Если работа успешно выполнилась, установите этот параметр на 0. Иначе, укажите надлежащий код ошибки.

Обсуждение

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

Типы данных

ConstFSSpecPtr ConstFSSpecPtr

Представляет тип, используемый по условию Компоненты API.

Объявление

Swift

typealias ConstFSSpecPtr = UnsafePointer<FSSpec>

Objective C

typedef const FSSpec * ConstFSSpecPtr;

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

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

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

Представляет тип, используемый по условию Компоненты API.

Объявление

Objective C

typedef ComponentInstance DataCodecComponent;

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Не доступный 64-разрядным приложениям.
DataHCompletionUPP DataHCompletionUPP

Представляет тип, используемый по условию Компоненты API.

Объявление

Objective C

typedef STACK_UPP_TYPE(DataHCompletionProcPtr) DataHCompletionUPP;

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Не доступный 64-разрядным приложениям.
DataHFileTypeOrderingHandle DataHFileTypeOrderingHandle

Представляет тип, используемый по условию Компоненты API.

Объявление

Objective C

typedef DataHFileTypeOrderingPtr * DataHFileTypeOrderingHandle;

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Не доступный 64-разрядным приложениям.
DataHFileTypeOrderingPtr DataHFileTypeOrderingPtr

Представляет тип, используемый по условию Компоненты API.

Объявление

Objective C

typedef OSType * DataHFileTypeOrderingPtr;

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Не доступный 64-разрядным приложениям.
DataHSchedulePtr DataHSchedulePtr

Представляет тип, используемый по условию Компоненты API.

Объявление

Objective C

typedef DataHScheduleRecord * DataHSchedulePtr;

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Не доступный 64-разрядным приложениям.
DataHScheduleRecord
Предоставляет информацию планирования для запланированных чтений.

Объявление

Objective C

struct DataHScheduleRecord { TimeRecord timeNeededBy; long extendedID; long extendedVers; Fixed priority; };
Поля
timeNeededBy

Обсуждение

Указывает время, в которое Ваш обработчик данных должен поставить запрошенные данные программе вызова. Эта временная стоимость относительно основы времени, содержащейся в этой записи времени. Во время операций перед рулоном Панель инструментов Фильма может использовать специальные значения в определенных полях записи времени. Рассматриваемые поля записи времени scale и поля значения. Путем корректной интерпретации values из этих полей Ваш обработчик данных может стоять в очереди запросы чтения перед рулоном самым эффективным способом к его устройству.

extendedID
Обсуждение

Константа (см. ниже), который указывает тип данных, следующих в остатке от структуры. Посмотрите эти константы:

kDataHExtendedSchedule
extendedVers

Обсуждение

Зарезервированный. Это поле должно всегда устанавливаться в 0.

приоритет

Обсуждение

Указывает относительную важность запроса данных. Клиентские программы присваиваются, значение 100,0 к данным запрашивает, чтобы был поставлен должен. Нижние значения указывают относительно менее критические данные. Если Ваш обработчик данных должен разместить ограничения пропускной способности при поставке данных, компонент может использовать это значение в качестве индикации, которой запросы могут быть отброшены с наименьшим количеством влияния на клиентскую программу. Как пример, рассмотрите использование приоритетов в фильме кадра-differenced. Ключевые кадры могли бы иметь приоритетные значения 100,0, указывая, что они важны для надлежащего воспроизведения. Когда Вы перемещаетесь через кадры после ключевого кадра, каждый последовательный кадр мог бы иметь более низкое приоритетное значение. Как только Вы отбрасываете кадр, необходимо отбросить все последовательные кадры равного или более низкого приоритета, пока Вы не достигаете другого ключевого кадра, потому что каждый из этих кадров полагался бы на отброшенный для некоторых данных изображения.
Обсуждение

Существует два типа операций чтения перед рулоном. Первый тип является требуемым чтением; т.е. Панель инструментов Фильма требует, чтобы операция чтения была удовлетворена, прежде чем фильм начнет играть. Второй тип является дополнительным чтением. Если Ваш обработчик данных может удовлетворить операцию чтения как часть работы перед рулоном, это должно сделать так. Иначе, в то время как фильм играет, Ваш обработчик данных может удовлетворить запрос в требуемое время. Панель инструментов Фильма указывает, что запрос чтения перед рулоном требуется путем установки scale поле времени записывает к-1. Это буквально означает, что запрос планируется какое-то время, который бесконечно далек в будущее. Когда Панель инструментов Фильма вызывает Ваш компонент, Ваш обработчик данных должен собрать все такие запросы чтения, упорядочить их наиболее эффективно для Вашего устройства и обработать их DataHFinishData функция. Поскольку дополнительный предварительный рулон считал запросы, Панель инструментов Фильма устанавливает scale поле должным образом, но инвертирует contents из value поле. Ваш обработчик данных имеет опцию поставки данных для этого запроса с требуемыми данными, если это может быть сделано эффективно. Иначе, Ваш обработчик данных может поставить данные в свое время расписания. Вы определяете запланированное время путем отрицания contents из value поле (т.е. умножаясь на-1).
DataHVolumeList DataHVolumeList

Представляет тип, используемый по условию Компоненты API.

Объявление

Objective C

typedef DataHVolumeListPtr * DataHVolumeList;

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Не доступный 64-разрядным приложениям.
DataHVolumeListPtr DataHVolumeListPtr

Представляет тип, используемый по условию Компоненты API.

Объявление

Objective C

typedef DataHVolumeListRecord * DataHVolumeListPtr;

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Не доступный 64-разрядным приложениям.
XMLDoc XMLDoc

Представляет тип, используемый по условию Компоненты API.

Объявление

Objective C

typedef XMLDocRecord * XMLDoc;

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

Objective C

@import QuickTime;

Доступность

Доступный в OS X v10.0 и позже.
Не доступный 64-разрядным приложениям.
XMLDocRecord

Недокументированный

Объявление

Objective C

struct XMLDocRecord { void * xmlDataStorage; XMLElement rootElement; };

Поля
xmlDataStorage

Обсуждение

Недокументированный

rootElement

Обсуждение

Недокументированный

Константы

kDataHCanRead
Константы сгруппировались с kDataHCanRead.

Объявление

Objective C

enum { kDataHCanRead = 1L << 0, kDataHSpecialRead = 1L << 1, kDataHSpecialReadFile = 1L << 2, kDataHCanWrite = 1L << 3, kDataHSpecialWrite = 1 << 4, kDataHSpecialWriteFile = 1 << 5, kDataHCanStreamingWrite = 1 << 6, kDataHMustCheckDataRef = 1 << 7 };

Константы
- kDataHCanRead
  
  kDataHCanRead
  
  Указывает, что Ваш обработчик данных может читать из объема.
  
  Доступный в OS X v10.0 и позже.
  Не доступный 64-разрядным приложениям.
- kDataHSpecialRead
  
  kDataHSpecialRead
  
  Указывает, что Ваш обработчик данных может читать из объема с помощью специального метода. Например, Ваш обработчик данных мог бы доступ к поддержке к сетевым мультимедийным серверам с помощью особого протокола. В этом случае Ваш компонент установил бы этот флаг в 1 каждый раз, когда объем находится на поддерживаемом сервере.
  
  Доступный в OS X v10.0 и позже.
  Не доступный 64-разрядным приложениям.
- kDataHSpecialReadFile
  
  kDataHSpecialReadFile
  
  Зарезервированный для использования Apple.
  
  Доступный в OS X v10.0 и позже.
  Не доступный 64-разрядным приложениям.
- kDataHCanWrite
  
  kDataHCanWrite
  
  Указывает, что Ваш обработчик данных может записать данные в объем. В частности используйте этот флаг, чтобы указать что Ваш обработчик данных DataHPutData функция будет работать с этим объемом.
  
  Доступный в OS X v10.0 и позже.
  Не доступный 64-разрядным приложениям.
- kDataHSpecialWrite
  
  kDataHSpecialWrite
  
  Указывает, что Ваш обработчик данных может записать в объем с помощью специального метода. Как с kDataHSpecialRead флаг, Ваш обработчик данных использовал бы этот флаг, чтобы указать, что Ваш компонент может получить доступ к объему с помощью специализированной поддержки (например, специальные сетевые протоколы).
  
  Доступный в OS X v10.0 и позже.
  Не доступный 64-разрядным приложениям.
- kDataHCanStreamingWrite
  
  kDataHCanStreamingWrite
  
  Указывает, что Ваш обработчик данных может поддерживать специальные функции записи для получения данных фильма при записи в этот объем.
  
  Доступный в OS X v10.0 и позже.
  Не доступный 64-разрядным приложениям.
Значения DataHScheduleRecord

Константы передали DataHScheduleRecord.

Объявление

Objective C

enum { kDataHExtendedSchedule = 'xtnd' };
Значения DataHGetFileTypeOrdering

Константы передали DataHGetFileTypeOrdering.

Объявление

Objective C

enum { kDataHFileTypeMacOSFileType = 'ftyp', kDataHFileTypeExtension = 'fext', kDataHFileTypeMIME = 'mime' };
Значения DataHGetInfoFlags

Константы передали DataHGetInfoFlags.

Объявление

Objective C

enum { kDataHInfoFlagNeverStreams = 1 << 0, /* set if this data handler doesn't stream */ kDataHInfoFlagCanUpdateDataRefs = 1 << 1, /* set if this data handler might update data reference */ kDataHInfoFlagNeedsNetworkBandwidth = 1 << 2 /* set if this data handler may need to occupy the network */ };
Значения DataHSetMovieUsageFlags

Константы передали DataHSetMovieUsageFlags.

Объявление

Objective C

enum { kDataHMovieUsageDoAppendMDAT = 1L << 0 /* if set, datahandler should append wide and mdat atoms in append call */ };