LdrDisplayCbkReg: различия между версиями
Cool-T (обсуждение | вклад) (→Параметры) | NoPH8 (обсуждение | вклад) м (Снята защита с «LdrDisplayCbkReg») | ||
(не показано 38 промежуточных версий 6 участников) | |||
Строка 8: | Строка 8: | ||
== Параметры == | == Параметры == | ||
− | + | #'''dispCbk cbk | |
− | + | #:Указатель на функцию-колбек, которая будет вызываться при обновлении участка экрана | |
− | + | #'''RECT_T *target | |
− | + | #:Указатель на область экрана для вызова колбека. Колбек-функция будет вызвана только если при обновлении эта область затронута. | |
− | + | #:Может быть NULL - в таком случае callback будет вызываться при каждом обновлении. | |
− | + | #'''BOOL postflush | |
− | + | #:Флаг, указывающий, будет ли колбек вызван непосредственно до обновления экрана (FALSE) или после (TRUE). | |
− | : | ||
== Результат == | == Результат == | ||
− | '''BOOL | + | #'''BOOL |
− | :Результат операции, TRUE | + | #:Результат операции, TRUE в случае успеха. |
+ | #:FALSE может возвращаться в случае достижения максимального количества зарегистрированных колбеков (обычно 8). | ||
== Пример == | == Пример == | ||
Строка 27: | Строка 27: | ||
void CallbackFn( const RECT_T * updatedRect ) | void CallbackFn( const RECT_T * updatedRect ) | ||
{ | { | ||
− | + | ... | |
} | } | ||
Строка 41: | Строка 41: | ||
[[AHI]] | [[AHI]] | ||
+ | |||
[[Категория:Функции ElfPack2]] | [[Категория:Функции ElfPack2]] |
Текущая версия на 17:21, 9 октября 2011
Объявление
BOOL ldrDisplayCbkReg( dispCbk cbk, RECT_T *target, BOOL postflush );
Описание
Функция ElfPack2, позволяет зарегистрировать коллбек(callback) функцию на обновление участка экрана.
Используется для вывода графики средствами ATI поверх основного UIS. Например, этот способ использует консоль.
Параметры
- dispCbk cbk
- Указатель на функцию-колбек, которая будет вызываться при обновлении участка экрана
- RECT_T *target
- Указатель на область экрана для вызова колбека. Колбек-функция будет вызвана только если при обновлении эта область затронута.
- Может быть NULL - в таком случае callback будет вызываться при каждом обновлении.
- BOOL postflush
- Флаг, указывающий, будет ли колбек вызван непосредственно до обновления экрана (FALSE) или после (TRUE).
Результат
- BOOL
- Результат операции, TRUE в случае успеха.
- FALSE может возвращаться в случае достижения максимального количества зарегистрированных колбеков (обычно 8).
Пример
// Функция, в которой происходит отрисовка // updatedRect - обновляемая область void CallbackFn( const RECT_T * updatedRect ) { ... } // Область статусной строки const RECT_T cbkRect = { 0, 0, 176, 24 }; // Регистрируем наш callback ldrDisplayCbkReg( CallbackFn, &cbkRect, TRUE );