os_mb.h 函数

📚 本节导读

用途: 邮箱 API 函数声明

来源: kernel/include/os_mb.h:60

一、邮箱创建

os_mb_create

os_mb_id os_mb_create(const char *name, os_size_t size);

功能: 创建邮箱

参数:

• name: 邮箱名称
• size: 邮箱容量（最大条数）

os_mb_delete

os_err_t os_mb_delete(os_mb_id mb);

功能: 删除邮箱

---

二、邮箱操作

os_mb_send

os_err_t os_mb_send(os_mb_id mb, void *msg, os_uint32_t timeout);

功能: 发送消息（指针）

os_mb_recv

os_err_t os_mb_recv(os_mb_id mb, void **msg, os_uint32_t timeout);

功能: 接收消息（指针）

os_mb_peek

os_err_t os_mb_peek(os_mb_id mb, void **msg, os_uint16_t offset);

功能: 查看指定位置消息（不删除）

---

三、静态邮箱管理

OS_MB_DEFINE

#define OS_MB_DEFINE(name, size)                                \
    os_mb_dummy_t _mb_obj_##name;                              \
    void *_mb_buffer_##name[size]

功能: 静态定义邮箱

os_mb_init

os_err_t os_mb_init(os_mb_id mb, const char *name, void *msg_pool,
                    os_size_t size);

功能: 初始化静态邮箱

os_mb_deinit

os_err_t os_mb_deinit(os_mb_id mb);

功能: 反初始化静态邮箱

---