?? queue.h
字號(hào):
/***********************************************Copyright (c)*********************************************
** Guangzou ZLG-MCU Development Co.,LTD.
**
** http://www.zlgmcu.com
**
**--------------File Info---------------------------------------------------------------------------------
** File name: queue.h
** Last modified Date: 2007-09-20
** Last Version: 1.0
** Descriptions: 數(shù)據(jù)隊(duì)列中間件
**
**--------------------------------------------------------------------------------------------------------
** Created by: chengmingji
** Created date: 2007-07-08
** Version: 1.0
** Descriptions:
**
**--------------------------------------------------------------------------------------------------------
** Modified by: lixiaocheng
** Modified Date: 2007-09-08
** Version: 1.0
** Descriptions: 對代碼格式重新排版
**
*********************************************************************************************************/
#ifndef __QUEUE_H
#define __QUEUE_H
/*********************************************************************************************************
隊(duì)列操作返回
*********************************************************************************************************/
#ifndef NOT_OK
#define NOT_OK -1 /* 參數(shù)錯(cuò)誤 */
#endif
#define QUEUE_OK 1 /* 操作成功 */
#define QUEUE_FULL 8 /* 返回隊(duì)列滿狀態(tài) */
#define QUEUE_EMPTY 4 /* 返回隊(duì)列空狀態(tài) */
/*********************************************************************************************************
下面的宏定義是傳遞給用戶處理隊(duì)列滿時(shí)，判斷對立是FIFO,還是LIFO
*********************************************************************************************************/
#define Q_WRITE_MODE 1 /* 操作成功 */
#define Q_WRITE_FRONT_MODE 2 /* 操作成功 */
/*********************************************************************************************************
定義數(shù)據(jù)隊(duì)列的數(shù)據(jù)類型
*********************************************************************************************************/
#ifndef QUEUE_DATA_TYPE
#define QUEUE_DATA_TYPE uint8
#endif
/*********************************************************************************************************
定義數(shù)據(jù)隊(duì)列結(jié)構(gòu)體
*********************************************************************************************************/
typedef struct {
QUEUE_DATA_TYPE *Out; /* 指向數(shù)據(jù)輸出位置 */
QUEUE_DATA_TYPE *In; /* 指向數(shù)據(jù)輸入位置 */
QUEUE_DATA_TYPE *End; /* 指向Buf的結(jié)束位置 */
uint16 NData; /* 隊(duì)列中數(shù)據(jù)個(gè)數(shù) */
uint16 MaxData; /* 隊(duì)列中允許存儲(chǔ)的數(shù)據(jù)個(gè)數(shù) */
uint8 (* ReadEmpty)(); /* 讀空處理函數(shù) */
uint8 (* WriteFull)(); /* 寫滿處理函數(shù) */
QUEUE_DATA_TYPE Buf[1]; /* 存儲(chǔ)數(shù)據(jù)的空間 */
} DataQueue;
/*********************************************************************************************************
如果用戶自己寫數(shù)據(jù)隊(duì)列，可以定義這個(gè)宏開關(guān)就可關(guān)閉下面的函數(shù)聲明
*********************************************************************************************************/
#ifndef IN_QUEUE
/*********************************************************************************************************
** Function name: QueueCreate
** Descriptions: 初始化數(shù)據(jù)隊(duì)列
** Input parameters: Buf ：為隊(duì)列分配的存儲(chǔ)空間地址
** SizeOfBuf：為隊(duì)列分配的存儲(chǔ)空間大小（字節(jié)）
** ReadEmpty：為隊(duì)列讀空時(shí)處理程序
** WriteFull：為隊(duì)列寫滿時(shí)處理程序
** Output parameters: NONE
** Returned value: NOT_OK :參數(shù)錯(cuò)誤
** QUEUE_OK:成功
*********************************************************************************************************/
int QueueCreate(void *Buf,
uint32 SizeOfBuf,
uint8 (* ReadEmpty)(),
uint8 (* WriteFull)()
);
/*********************************************************************************************************
** Function name: QueueRead
** Descriptions: 獲取隊(duì)列中的數(shù)據(jù)
** Input parameters: Ret:存儲(chǔ)返回的消息的地址
** Buf:指向隊(duì)列的指針
** Output parameters: NONE
** Returned value: NOT_OK ：參數(shù)錯(cuò)誤
** QUEUE_OK ：收到消息
** QUEUE_EMPTY：隊(duì)列空
*********************************************************************************************************/
int QueueRead(QUEUE_DATA_TYPE *Ret, void *Buf);
/*********************************************************************************************************
** Function name: QueueWrite
** Descriptions: FIFO方式發(fā)送數(shù)據(jù)
** Input parameters: Buf :指向隊(duì)列的指針
** Data:發(fā)送的數(shù)據(jù)
** Output parameters: NONE
** Returned value: NOT_OK : 參數(shù)錯(cuò)誤
** QUEUE_FULL: 隊(duì)列滿
** QUEUE_OK : 發(fā)送成功
*********************************************************************************************************/
int QueueWrite(void *Buf, QUEUE_DATA_TYPE Data);
/*********************************************************************************************************
** Function name: QueueWriteFront
** Descriptions: LIFO方式發(fā)送數(shù)據(jù)
** Input parameters: Buf :指向隊(duì)列的指針
** Data:發(fā)送的數(shù)據(jù)
** Output parameters: NONE
** Returned value: NOT_OK : 參數(shù)錯(cuò)誤
** QUEUE_FULL: 隊(duì)列滿
** QUEUE_OK : 發(fā)送成功
*********************************************************************************************************/
int QueueWriteFront(void *Buf, QUEUE_DATA_TYPE Data);
/*********************************************************************************************************
** Function name: QueueNData
** Descriptions: 取得隊(duì)列中數(shù)據(jù)數(shù)
** Input parameters: Buf :指向隊(duì)列的指針
** Output parameters: NONE
** Returned value: 隊(duì)列包含數(shù)據(jù)數(shù)
*********************************************************************************************************/
uint16 QueueNData(void *Buf);
/*********************************************************************************************************
** Function name: QueueSize
** Descriptions: 取得隊(duì)列總?cè)萘?** Input parameters: Buf :指向隊(duì)列的指針
** Output parameters: NONE
** Returned value: 隊(duì)列總?cè)萘?*********************************************************************************************************/
uint16 QueueSize(void *Buf);
/*********************************************************************************************************
** Function name: OSQFlush
** Descriptions: 清空隊(duì)列
** Input parameters: Buf :指向隊(duì)列的指針
** Output parameters: NONE
** Returned value: NONE
*********************************************************************************************************/
void QueueFlush(void *Buf);
#endif /* IN_QUEUE */
/*********************************************************************************************************
對中間件隊(duì)列函數(shù)進(jìn)行剪裁，如果是以.a方式提供該驅(qū)動(dòng)庫，該宏只表示那些函數(shù)是被剪裁了
*********************************************************************************************************/
#define EN_QUEUE_WRITE 1 /* 禁止(0)或允許(1)FIFO發(fā)送數(shù)據(jù) */
#define EN_QUEUE_WRITE_FRONT 0 /* 禁止(0)或允許(1)LIFO發(fā)送數(shù)據(jù) */
#define EN_QUEUE_NDATA 0 /* 禁止(0)或允許(1)取得隊(duì)列 */
/* 數(shù)據(jù)數(shù)目 */
#define EN_QUEUE_SIZE 0 /* 禁止(0)或允許(1)取得隊(duì)列 */
/* 數(shù)據(jù)總?cè)萘? */
#define EN_QUEUE_FLUSH 1 /* 禁止(0)或允許(1)清空隊(duì)列 */
#endif /* __QUEUE_H */
/*********************************************************************************************************
END FILE
*********************************************************************************************************/
?? 快捷鍵說明
復(fù)制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號(hào)
Ctrl + =
減小字號(hào)
Ctrl + -