84
правкиИзменения
Нет описания правки
<tt>UINT32 '''AFW_AddEvAux'''( EVENT_STACK_T * ev_st, UINT32 event_code, FREE_BUF_FLAG_T fbf, UINT32 att_size, void * attachment );</tt>
== Описание ==
Функция [[AFW]] добавления ивента с только auxiliary (англ. ''вспомогательный'') данными, которые могут быть неограниченного размера.
Возвращает RESULT_OK в случае успеха.
== Параметры ==
#'''EVENT_STACK_T * ev_st
#:Указатель на event stack, передаваемый в функцию
#'''UINT32 event_code
#:Код передаваемого ивента
#'''FREE_BUF_FLAG_T fbf
#:Флаг, указывающий способ освобождения присоединения после использования ивента:
#:*<tt>FBF_FREE</tt> - ОС при удалении ивента освободит attachment
#:*<tt>FBF_LEAVE</tt> - приложение дожно заботиться об освобождении
#'''UINT32 att_size
#:Размер прикреплённых данных
#'''void * attachment
#:Указатель на прикреплённые данные
== Пример ==
<pre>
const WCHAR * str = L"Attachment data";
// Добавляем ивент с кодом 0xFFFF, и аттачем в стек
// используем FBF_LEAVE т.к. данные не выделены динамически
AFW_AddEvAux(ev_st, 0xFFFF, FBF_LEAVE, (u_strlen(str)+1)*sizeof(WCHAR), str);
</pre>
[[Категория:Функции AFW]]
== Описание ==
Функция [[AFW]] добавления ивента с только auxiliary (англ. ''вспомогательный'') данными, которые могут быть неограниченного размера.
Возвращает RESULT_OK в случае успеха.
== Параметры ==
#'''EVENT_STACK_T * ev_st
#:Указатель на event stack, передаваемый в функцию
#'''UINT32 event_code
#:Код передаваемого ивента
#'''FREE_BUF_FLAG_T fbf
#:Флаг, указывающий способ освобождения присоединения после использования ивента:
#:*<tt>FBF_FREE</tt> - ОС при удалении ивента освободит attachment
#:*<tt>FBF_LEAVE</tt> - приложение дожно заботиться об освобождении
#'''UINT32 att_size
#:Размер прикреплённых данных
#'''void * attachment
#:Указатель на прикреплённые данные
== Пример ==
<pre>
const WCHAR * str = L"Attachment data";
// Добавляем ивент с кодом 0xFFFF, и аттачем в стек
// используем FBF_LEAVE т.к. данные не выделены динамически
AFW_AddEvAux(ev_st, 0xFFFF, FBF_LEAVE, (u_strlen(str)+1)*sizeof(WCHAR), str);
</pre>
[[Категория:Функции AFW]]