X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=Include%2Fvos_que.h;fp=Include%2Fvos_que.h;h=5c9adc1205aa78f6b87d92e001dd4d5ebe2bc5df;hb=e93798699eccb72af04938fc9b0d7a836e284488;hp=28f622e08af42848d7dd1d85d9b9751b5973d337;hpb=94f13ab3e8da393eb27ccc561d31b447b1367c56;p=scp%2Focu%2F5gnr.git diff --git a/Include/vos_que.h b/Include/vos_que.h index 28f622e..5c9adc1 100644 --- a/Include/vos_que.h +++ b/Include/vos_que.h @@ -1,9 +1,21 @@ /****************************************************************************** -############################################################################### -# Copyright (c) [2017-2020] [ICT/CAS] # -# Licensed under the ORAN Software License v1.0 (License) # -############################################################################### -******************************************************************************/ +* +* Copyright (c) 2020 ICT/CAS. +* +* Licensed under the O-RAN Software License, Version 1.0 (the "Software License"); +* you may not use this file except in compliance with the License. +* You may obtain a copy of the License at +* +* https://www.o-ran.org/software +* +* Unless required by applicable law or agreed to in writing, software +* distributed under the License is distributed on an "AS IS" BASIS, +* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +* See the License for the specific language governing permissions and +* limitations under the License. +* +*******************************************************************************/ + #ifndef __VOS_QUE_H__ @@ -38,24 +50,24 @@ typedef enum { }VOS_msgq_pri_t; -/** +/** * 创建消息队列 * @param[in] lMaxMsgs 消息队列中最大消息数目 * @param[in] lOptions 选项,VOS_msgq_type_t 类型,linux中支持MSG_Q_FIFO和MSG_Q_PRIORITY * @return 成功返回队列ID,失败则返回 0 - */ + */ ULONG VOS_QueCreate(LONG lMaxMsgs, LONG lOptions); -/** +/** * 删除队列 * @param[in] msgQId 消息队列ID * @return 成功返回队列ID,失败则返回 0 - */ + */ LONG VOS_QueDelete(ULONG msgQId); -/** +/** * 向消息队列发消息 * @param[in] msgQId 消息队列ID * @param[in] aulMsg 发送的消息,含有VOS_QUEUE_MSG_SIZE个ULONG的数组 @@ -64,11 +76,11 @@ LONG VOS_QueDelete(ULONG msgQId); * @param[in] lPriority 消息的优先级。分为MSG_PRI_NORMAL和MSG_PRI_URGENT两种。 * @return VOS_OK - 成功,其他 - 失败 * @note WINDOWS中存在Bug,队列满了后,不能等待,只能返回失败 - */ + */ LONG VOS_QueSend(ULONG msgQId, ULONG aulMsg[VOS_QUEUE_MSG_SIZE], LONG lMsec, LONG lPriority); -/** +/** * 从消息队列接受 * @param[in] msgQId 消息队列ID * @param[in] aulMsg 接收的消息,含有VOS_QUEUE_MSG_SIZE个ULONG的数组 @@ -77,11 +89,11 @@ LONG VOS_QueSend(ULONG msgQId, ULONG aulMsg[VOS_QUEUE_MSG_SIZE], LONG lMsec, LON * @return 失败为VOS_ERROR;成功时如果消息队列中消息数为0 则返回VOS_NO_MSG, * 如果消息队列中消息数不为0 ,则返回VOS_HAVE_MSG。 * @note 一般任务的入口函数就阻塞在VOS_QueReceive。 - */ + */ LONG VOS_QueReceive(ULONG msgQId, ULONG aulMsg[VOS_QUEUE_MSG_SIZE], LONG lMsec); -/** +/** * 将队列和任务绑定,用于队列管理,一般创建完队列和任务后调用 * @param[in] hTask 任务句柄 * @param[in] ulQId 消息队列ID @@ -89,14 +101,14 @@ LONG VOS_QueReceive(ULONG msgQId, ULONG aulMsg[VOS_QUEUE_MSG_SIZE], LONG lMsec); VOID VOS_QueBindTask(VOS_HANDLE hTask, ULONG ulQId); -/** +/** * 获得队列中消息的数目 * @param[in] msgQId 消息队列ID * @return 成功则返回消息队列中消息的数目,失败则VOS_ERROR。 */ LONG VOS_QueNum(ULONG msgQId); -/** +/** * 删除所有创建的消息队列 * @return 成功VOS_OK */