133 #ifndef ti_ipc_MessageQ__include
134 #define ti_ipc_MessageQ__include
138 #if defined (__cplusplus)
150 #define MessageQ_S_BUSY (2)
155 #define MessageQ_S_ALREADYSETUP (1)
160 #define MessageQ_S_SUCCESS (0)
165 #define MessageQ_E_FAIL (-1)
170 #define MessageQ_E_INVALIDARG (-2)
175 #define MessageQ_E_MEMORY (-3)
180 #define MessageQ_E_ALREADYEXISTS (-4)
185 #define MessageQ_E_NOTFOUND (-5)
190 #define MessageQ_E_TIMEOUT (-6)
195 #define MessageQ_E_INVALIDSTATE (-7)
200 #define MessageQ_E_OSFAILURE (-8)
205 #define MessageQ_E_RESOURCE (-9)
210 #define MessageQ_E_RESTART (-10)
215 #define MessageQ_E_INVALIDMSG (-11)
220 #define MessageQ_E_NOTOWNER (-12)
225 #define MessageQ_E_REMOTEACTIVE (-13)
230 #define MessageQ_E_INVALIDHEAPID (-14)
235 #define MessageQ_E_INVALIDPROCID (-15)
240 #define MessageQ_E_MAXREACHED (-16)
245 #define MessageQ_E_UNREGISTEREDHEAPID (-17)
250 #define MessageQ_E_CANNOTFREESTATICMSG (-18)
255 #define MessageQ_E_UNBLOCKED (-19)
265 #define MessageQ_FOREVER (~(0))
270 #define MessageQ_INVALIDMSGID (0xffff)
275 #define MessageQ_INVALIDMESSAGEQ (0xffff)
280 #define MessageQ_PRIORITYMASK (0x3)
292 #define MessageQ_getDstQueue(msg) \
293 ((msg)->dstId == (MessageQ_QueueIndex)MessageQ_INVALIDMESSAGEQ) ? \
294 (MessageQ_QueueId)MessageQ_INVALIDMESSAGEQ : \
295 (MessageQ_QueueId)(((MessageQ_QueueId)MultiProc_self() << 16u) \
296 | (((MessageQ_Msg)(msg))->dstId))
313 #define MessageQ_getMsgId(msg) (((MessageQ_Msg) (msg))->msgId)
323 #define MessageQ_getMsgSize(msg) (((MessageQ_Msg) (msg))->msgSize)
332 #define MessageQ_getMsgPri(msg) \
333 ((((MessageQ_Msg) (msg))->flags & MessageQ_PRIORITYMASK))
345 #define MessageQ_getProcId(queueId) \
346 ((UInt16)((queueId) >> 16))
365 #define MessageQ_getReplyQueue(msg) \
366 (MessageQ_QueueId)((((MessageQ_Msg) (msg))->replyProc << 16u) \
367 | ((MessageQ_Msg)(msg))->replyId)
381 #define MessageQ_setMsgId(msg, id) ((MessageQ_Msg) (msg))->msgId = (id)
389 #define MessageQ_setMsgPri(msg, priority) \
390 (((MessageQ_Msg) (msg))->flags = ((priority) & MessageQ_PRIORITYMASK))
500 #define MessageQ_ANY (Bits16)~(0)
820 Int
MessageQ_get(MessageQ_Handle handle, MessageQ_Msg *msg, UInt timeout);
850 Int
MessageQ_put(MessageQ_QueueId queueId, MessageQ_Msg msg);
924 #if defined (__cplusplus)
Int MessageQ_free(MessageQ_Msg msg)
Frees a message back to the heap.
Int MessageQ_get(MessageQ_Handle handle, MessageQ_Msg *msg, UInt timeout)
Gets a message from the message queue.
Void MessageQ_setFreeHookFxn(MessageQ_FreeHookFxn freeHookFxn)
Sets MessageQ's free hook function.
MessageQ_Priority
Message priority.
Definition: MessageQ.h:487
Structure defining parameters for MessageQ_create().
Definition: MessageQ.h:415
Int MessageQ_delete(MessageQ_Handle *handlePtr)
Delete a created MessageQ instance.
MessageQ_Handle MessageQ_create2(String name, const MessageQ_Params2 *params)
Create a MessageQ instance with the MessageQ_Params2 structure.
Int MessageQ_open(String name, MessageQ_QueueId *queueId)
Open a message queue.
Definition: MessageQ.h:491
Int MessageQ_registerHeap(Ptr heap, UInt16 heapId)
Register a heap with MessageQ.
Definition: MessageQ.h:489
Void * synchronizer
Definition: MessageQ.h:416
UInt32 MessageQ_getQueueId(MessageQ_Handle handle)
Returns the QueueId associated with the handle.
UInt16 MessageQ_QueueIndex
Local queue index.
Definition: MessageQ.h:405
MessageQ_MsgHeader * MessageQ_Msg
Typedef for ease of use.
Definition: MessageQ.h:482
Definition: MessageQ.h:488
Void(* MessageQ_FreeHookFxn)(Bits16 heapId, Bits16 msgId)
Free hook prototype.
Definition: MessageQ.h:508
struct MessageQ_Object * MessageQ_Handle
MessageQ_Handle type.
Definition: MessageQ.h:410
MessageQ_Msg MessageQ_alloc(UInt16 heapId, UInt32 size)
Allocates a message from the heap.
Int MessageQ_count(MessageQ_Handle handle)
Returns the number of messages in a message queue.
Void * synchronizer
Definition: MessageQ.h:434
Void MessageQ_Params2_init(MessageQ_Params2 *params)
Initialize MessageQ_Params2.
Void MessageQ_unblock(MessageQ_Handle handle)
Unblocks a MessageQ.
UInt32 MessageQ_QueueId
A 32-bit value that uniquely identifies a message queue.
Definition: MessageQ.h:400
Int MessageQ_put(MessageQ_QueueId queueId, MessageQ_Msg msg)
Place a message onto a message queue.
Void MessageQ_Params_init(MessageQ_Params *params)
Initialize MessageQ_Params.
MessageQ_QueueIndex queueIndex
Definition: MessageQ.h:443
Structure defining parameters for MessageQ_create2().
Definition: MessageQ.h:433
Int MessageQ_unregisterHeap(UInt16 heapId)
Unregister a heap with MessageQ.
Definition: MessageQ.h:490
Int MessageQ_close(MessageQ_QueueId *queueId)
Close the opened handle.
Void MessageQ_setReplyQueue(MessageQ_Handle handle, MessageQ_Msg msg)
Embeds a source message queue into a message.
MessageQ_QueueId MessageQ_openQueueId(UInt16 queueIndex, UInt16 remoteProcId)
Opens a MessageQ given the queue index and remote processor id.
MessageQ_Handle MessageQ_create(String name, const MessageQ_Params *params)
Create a MessageQ instance.
Void MessageQ_staticMsgInit(MessageQ_Msg msg, UInt32 size)
Initializes a message not obtained from MessageQ_alloc()
Void MessageQ_setMsgTrace(MessageQ_Msg msg, Bool traceFlag)
Sets the message tracing flag on a given message.