Открыть главное меню

LdrDisplayCbkReg: различия между версиями

(Параметры)
м (Снята защита с «LdrDisplayCbkReg»)
 
(не показано 38 промежуточных версий 6 участников)
Строка 8:Строка 8:
  
 
== Параметры ==
 
== Параметры ==
:'''dispCbk cbk
+
#'''dispCbk cbk
::Указатель на функцию, которая будет выполняться при перерисовке изображения на экране
+
#:Указатель на функцию-колбек, которая будет вызываться при обновлении участка экрана
 
+
#'''RECT_T *target
:'''RECT_T *cbkRect
+
#:Указатель на область экрана для вызова колбека. Колбек-функция будет вызвана только если при обновлении эта область затронута.
::Указатель на область экрана.
+
#:Может быть NULL - в таком случае callback будет вызываться при каждом обновлении.
 
+
#'''BOOL postflush
:'''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. Например, этот способ использует консоль.

Параметры

  1. dispCbk cbk
    Указатель на функцию-колбек, которая будет вызываться при обновлении участка экрана
  2. RECT_T *target
    Указатель на область экрана для вызова колбека. Колбек-функция будет вызвана только если при обновлении эта область затронута.
    Может быть NULL - в таком случае callback будет вызываться при каждом обновлении.
  3. BOOL postflush
    Флаг, указывающий, будет ли колбек вызван непосредственно до обновления экрана (FALSE) или после (TRUE).

Результат

  1. BOOL
    Результат операции, TRUE в случае успеха.
    FALSE может возвращаться в случае достижения максимального количества зарегистрированных колбеков (обычно 8).

Пример

// Функция, в которой происходит отрисовка
// updatedRect - обновляемая область
void CallbackFn( const RECT_T * updatedRect )
{	...
}
// Область статусной строки
const RECT_T	cbkRect = { 0, 0, 176, 24 };
// Регистрируем наш callback
ldrDisplayCbkReg( CallbackFn, &cbkRect, TRUE );

См. также

ldrDisplayCbkUnReg

AHI