os_lock_query

所属模块:系统控制 | 类型:状态查询函数

API Metadata

函数ID:os_lock_query
模块:system
类型:lock status query
嵌套深度:1

函数简介

os_lock_query 用于查询当前系统任务注册锁状态。

当系统处于锁定状态时,任务注册与部分系统配置操作将被禁止执行。

该接口常用于调试或系统状态监控,以判断系统是否允许进行任务配置操作。

函数原型

char os_lock_query(void);

参数说明

无参数。

返回值

1:系统处于锁定状态
0:系统未锁定

源码实现

/*------------------------------------------------------------------------ | FILE DESCRIPTION | ------------------------------------------------------------------------*/ /*------------------------------------------------------------------------ | - File name : lock_query.c | - Author : 谭舒 | - Update date : 2026-09-19 | - Copyright(C) : 2026 HRTOS. All rights reserved. ------------------------------------------------------------------------*/ /*------------------------------------------------------------------------ | INCLUDES | ------------------------------------------------------------------------*/ #include "hrtos_internal.h" /*------------------------------------------------------------------------ | API FUNCTIONS | ------------------------------------------------------------------------*/ /** * @brief 查询当前系统配置锁状态。 * * @param[in] None * * @return 系统配置锁状态。 * @retval 1 系统配置已锁定。 * @retval 0 系统配置未锁定。 */ char os_lock_query() //查询当前任务注册锁状态 1锁定状态 0未锁定 { if(OS_CFG_LOCK) { return 1; } else { return 0; } } /*------------------------------------------------------------------------ | END OF FILE: lock_query.c | ------------------------------------------------------------------------*/

使用示例

void debug_lock() { if(os_lock_query()) { // 系统处于锁定状态 } else { // 系统允许配置 } }

注意事项

该接口仅用于状态查询,不会改变系统运行状态。 返回值可用于调试或系统初始化流程判断。

相关推荐