1 /* 2 * Copyright (C) 2016 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #ifndef _EVENT_Q_H_ 18 #define _EVENT_Q_H_ 19 20 21 #include <stdbool.h> 22 #include <stdint.h> 23 #include <plat/taggedPtr.h> 24 25 26 #define EVENT_TYPE_BIT_DISCARDABLE_COMPAT 0x80000000 /* some external apps are using this one */ 27 #define EVENT_TYPE_BIT_DISCARDABLE 0x8000 /* set for events we can afford to lose */ 28 29 struct EvtQueue; 30 31 typedef void (*EvtQueueForciblyDiscardEvtCbkF)(uint32_t evtType, void *evtData, TaggedPtr evtFreeData); 32 33 //multi-producer, SINGLE consumer queue 34 35 struct EvtQueue* evtQueueAlloc(uint32_t size, EvtQueueForciblyDiscardEvtCbkF forceDiscardCbk); 36 void evtQueueFree(struct EvtQueue* q); 37 bool evtQueueEnqueue(struct EvtQueue* q, uint32_t evtType, void *evtData, TaggedPtr evtFreeData, bool atFront /* do not set this unless you know the repercussions. read: never set this in new code */); 38 bool evtQueueDequeue(struct EvtQueue* q, uint32_t *evtTypeP, void **evtDataP, TaggedPtr *evtFreeDataP, bool sleepIfNone); 39 void evtQueueRemoveAllMatching(struct EvtQueue* q, bool (*match)(uint32_t evtType, const void *data, void *context), void *context); 40 41 #endif 42