161
правкаИзменения
Создал статью
== Объявление ==
'''<tt>BOOL ldrDisplayCbkReg( dispCbk cbk, RECT_T *target, BOOL postflush );</tt>
== Описание ==
Функция [[ElfPack2]], позволяет зарегистрировать коллбек(callback) функцию на обновление участка экрана.
Используется для вывода графики средствами ATI '''поверх''' основного UIS. Например, этот способ использует консоль.
== Параметры ==
#'''dispCbk cbk
#:Указатель на функцию-колбек, которая будет вызываться при обновлении участка экрана
#'''RECT_T *target
#:Указатель на область экрана для вызова колбека. Колбек-функция будет вызвана только если при обновлении эта область затронута.
#:Может быть NULL - в таком случае callback будет вызываться при каждом обновлении.
#'''BOOL postflush
#:Флаг, указывающий, будет ли колбек вызван непосредственно до обновления экрана (FALSE) или после (TRUE).
== Результат ==
#'''BOOL
#:Результат операции, TRUE в случае успеха.
#:FALSE может возвращаться в случае достижения максимального количества зарегистрированных колбеков (обычно 8).
== Пример ==
<pre>
// Функция, в которой происходит отрисовка
// updatedRect - обновляемая область
void CallbackFn( const RECT_T * updatedRect )
{
...
}
// Область статусной строки
const RECT_T cbkRect = { 0, 0, 176, 24 };
// Регистрируем наш callback
ldrDisplayCbkReg( CallbackFn, &cbkRect, TRUE );
</pre>
== См. также ==
[[ldrDisplayCbkUnReg]]
[[AHI]]
[[Категория:Функции ElfPack2]]
'''<tt>BOOL ldrDisplayCbkReg( dispCbk cbk, RECT_T *target, BOOL postflush );</tt>
== Описание ==
Функция [[ElfPack2]], позволяет зарегистрировать коллбек(callback) функцию на обновление участка экрана.
Используется для вывода графики средствами ATI '''поверх''' основного UIS. Например, этот способ использует консоль.
== Параметры ==
#'''dispCbk cbk
#:Указатель на функцию-колбек, которая будет вызываться при обновлении участка экрана
#'''RECT_T *target
#:Указатель на область экрана для вызова колбека. Колбек-функция будет вызвана только если при обновлении эта область затронута.
#:Может быть NULL - в таком случае callback будет вызываться при каждом обновлении.
#'''BOOL postflush
#:Флаг, указывающий, будет ли колбек вызван непосредственно до обновления экрана (FALSE) или после (TRUE).
== Результат ==
#'''BOOL
#:Результат операции, TRUE в случае успеха.
#:FALSE может возвращаться в случае достижения максимального количества зарегистрированных колбеков (обычно 8).
== Пример ==
<pre>
// Функция, в которой происходит отрисовка
// updatedRect - обновляемая область
void CallbackFn( const RECT_T * updatedRect )
{
...
}
// Область статусной строки
const RECT_T cbkRect = { 0, 0, 176, 24 };
// Регистрируем наш callback
ldrDisplayCbkReg( CallbackFn, &cbkRect, TRUE );
</pre>
== См. также ==
[[ldrDisplayCbkUnReg]]
[[AHI]]
[[Категория:Функции ElfPack2]]