Получение текущего времени

Компоненты часов обеспечивают единственную функцию, ClockGetTime, это позволяет Панели инструментов Фильма получать текущее время.

Используя функции обратного вызова

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

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

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

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

Управление временем

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

Функции поддержки часов панели инструментов фильма

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

• Используйте AddCallBackToTimeBase функция для добавления события обратного вызова к списку запланированных событий обратного вызова, сохраняемых Панелью инструментов Фильма. Необходимо использовать RemoveCallBackFromTimeBase функция для удаления события обратного вызова из списка.

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

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

Типы данных

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

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

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

struct QTCallBackHeader {

    long    callBackFlags;    /* flags used by clock component to communicate

                                 scheduling data about callback to QuickTime */ 

    long    reserved1;        /* reserved for use by Apple */

    char   qtPrivate[40];    /* reserved for use by Apple */

};

Следующие флаги определяются для callBackFlags поле (все другие флаги должны быть установлены в 0):

enum {

    qtcbNeedsRateChanges = 1,       /* clock needs to know about rate

    qtcbNeedsTimeChanges = 2  /* clock needs to know about time

    qtcbNeedsStartStopChanges = 4   /* clock needs to know about

                                       time base changes */ 

};

Типы компонента для часов

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

#define clockComponentType        'clok'     /* clock component type */

#define systemTickClock           'tick'     /* system tick clock */

#define systemSecondClock         'seco'     /* system seconds clock */

#define systemMillisecondClock    'mill'     /* system millisecond clock */

#define systemMicrosecondClock    'micr'     /* system microsecond clock */