os_mailbox_clear

所属模块:通信机制 | 类型:邮箱清理函数

API Metadata

函数ID:os_mailbox_clear
模块:mailbox
类型:mailbox clear
嵌套深度:1

函数简介

os_mailbox_clear 用于清空邮箱资源内容, 将邮箱状态恢复为未使用状态。

该函数通常用于通信结束后的资源复位操作, 防止旧数据残留影响下一次通信。

函数原型

char os_mailbox_clear(u8 mid);

参数说明

参数 说明
mid 邮箱ID(0 ~ OS_RESOURCE_MAX-1)

返回值

1 - 清空成功
-1 - 参数错误

源码实现

#include "hrtos_internal.h" /* * 邮箱清除 */ char os_mailbox_clear(u8 mid) { OS_RESOURCE *m; if (mid >= OS_RESOURCE_MAX) { return -1; } m = &OS_RES[mid]; EA = 0; m->value = 0; EA = 1; return 1; }

使用示例

void task_cleanup() { os_mailbox_clear(1); }

注意事项

清空邮箱不会影响任务调度状态,仅重置数据内容。 调用前需确保当前通信已完成。

相关推荐