AFW AddEvAux

UINT32 AFW_AddEvAux( EVENT_STACK_T * ev_st, UINT32 event_code, FREE_BUF_FLAG_T fbf, UINT32 att_size, void * attachment );

Описание

Функция AFW добавления ивента с только auxiliary (англ. вспомогательный) данными, которые могут быть неограниченного размера.

Возвращает RESULT_OK в случае успеха.

Параметры

1. EVENT_STACK_T * ev_st

   Указатель на event stack, передаваемый в функцию

2. UINT32 event_code

   Код передаваемого ивента

3. FREE_BUF_FLAG_T fbf

   Флаг, указывающий способ освобождения присоединения после использования ивента:

   • FBF_FREE - ОС при удалении ивента освободит attachment
   • FBF_LEAVE - приложение дожно заботиться об освобождении

4. UINT32 att_size

   Размер прикреплённых данных

5. void * attachment

   Указатель на прикреплённые данные

Пример

const WCHAR * str = L"Attachment data";
// Добавляем ивент с кодом 0xFFFF, и аттачем в стек
// используем FBF_LEAVE т.к. данные не выделены динамически
AFW_AddEvAux(ev_st, 0xFFFF, FBF_LEAVE, (u_strlen(str)+1)*sizeof(WCHAR), str);