RAW queue 篇

jorya_txj

RAW queue 篇 [复制链接]

1        queue支持FIFO 和PRIO 的任务阻塞策略，如果是FIFO 的话阻塞队列的顺序是按照先来后到的次序去排列阻塞任务，PRIO 策略的话是按照优先级的排序。具体的设置可以直接设置这个结构体中的
typedef        struct RAW_COMMON_BLOCK_OBJECT {       
       
        LIST                                                                                                                block_list;
        RAW_U8                                                  *name;
        RAW_U8                                       block_way;
       
} RAW_COMMON_BLOCK_OBJECT;

block_way 可以为 RAW_BLOCKED_WAY_FIFO  或者RAW_BLOCKED_WAY_PRIO

2  RAW_U16 raw_queue_create(RAW_QUEUE  *p_q, RAW_U8    *p_name, RAW_VOID **msg_start, RAW_U32  number)

这个函数唯一要注意的参数是msg_start，需要传一个void * 指针数组的地进去比如  RAW_VOID *test_queue[100];传进去&test_queue


3 RAW_U16  raw_queue_front_post(RAW_QUEUE *p_q, RAW_VOID  *p_void, RAW_U32 wait_option)

这个函数实现的功能是把p_void  消息地址发送到队列头部去，支持发送队列满了睡眠的机制。如果发送队列满了，有很多任务block 在队列上等待发送，这样的效率是很慢的，往往设计出问题了，需要查设计问题。

4 RAW_U16  raw_queue_end_post(RAW_QUEUE *p_q, RAW_VOID  *p_void, RAW_U32 wait_option)

这个函数实现的功能是把p_void  消息地址发送到队列尾部去，支持发送队列满了睡眠的机制。如果发送队列满了，有很多任务block 在队列上等待发送，这样的效率是很慢的，往往设计出问题了，需要查设计问题。




5 RAW_U16 raw_queue_all_post(RAW_QUEUE *p_q, RAW_VOID  *p_void, RAW_U8 opt, RAW_U32 wait_option)

这个函数实现的功能是把p_void  消息地址发送到队列尾部或者队列头部去，根据具体的参数opt.支持发送队列满了睡眠的机制。如果发送队列满了，有很多任务block 在队列上等待发送，这样的效率是很慢的，往往设计出问题了，需要查设计问题。

6 RAW_U16 raw_queue_receive (RAW_QUEUE *p_q, RAW_U32 wait_option, RAW_VOID  **msg)

这个函数支持睡眠接收根据参数wait_option。需要注意的是参数msg,需要穿一个指针的地址进去，比如int *a; 传入参数&a.


7  RAW_U16 raw_queue_flush(RAW_QUEUE  *p_q)
  这个函数会清空所有的消息，如果有发送任务阻塞在队列上的话，会把所有发送任务唤醒。但是如果队列上是阻塞了接受任务的话，不会产生任何影响。被唤醒的任务会接收并返回RAW_BLOCK_ABORT


8  RAW_U16 raw_queue_delete(RAW_QUEUE *p_q)
   这个函数会唤醒所有block 在队列上的任务。被唤醒的任务会接收并返回RAW_BLOCK_DEL


9 RAW_U16 raw_queue_get_information(RAW_QUEUE *p_q, RAW_MSG_INFO *msg_information)

    这个函数会得到所有queue 上的信息等。