os_event_delete
所属模块:通信机制 | 类型:事件资源清理函数
函数简介
os_event_delete 用于清理指定事件槽位,
将事件状态重置为未使用状态。
该函数通常用于资源释放或任务退出后的事件回收。
函数原型
char os_event_delete(u8 obj);
参数说明
| 参数 |
说明 |
| obj |
事件ID(0 ~ OS_RESOURCE_MAX-1) |
源码实现
/*------------------------------------------------------------------------
| FILE DESCRIPTION |
------------------------------------------------------------------------*/
/*------------------------------------------------------------------------
| - File name : event_delete.c
| - Author : 谭舒
| - Update date : 2026-09-19
| - Copyright(C) : 2026 HRTOS. All rights reserved.
------------------------------------------------------------------------*/
/*------------------------------------------------------------------------
| INCLUDES |
------------------------------------------------------------------------*/
#include"hrtos_internal.h"
/*------------------------------------------------------------------------
| API FUNCTIONS |
------------------------------------------------------------------------*/
/**
* @brief 清理指定的事件资源槽位。
*
* @param[in] obj 事件资源槽位编号。
*
* @return 操作结果。
* @retval 1 清理成功。
* @retval -1 事件资源槽位编号无效。
*/
char os_event_delete(u8 obj)
{
if(obj >= OS_RESOURCE_MAX)
{
return -1;
}
OS_RES[obj].value = 0;
return 1;
}
/*------------------------------------------------------------------------
| END OF FILE: event_delete.c |
------------------------------------------------------------------------*/
使用示例
void task_cleanup()
{
os_event_delete(3);
}
注意事项
删除事件仅清空状态值,不会处理等待任务,调用前需确保资源已释放完成。