引 言
    提高软件代码的质量是每一个软件设计者都必须考虑的问题，这涉及软件的有效性和经济价值。基于嵌入式系统的软件设计多数是以实时操作系统为平台，这和传统的以WindOWS操作系统为平台的程序设计有很大的不同。前者要求对操作系统有更加深入的了解，要求使用者对自己的处理器和编译器工作原理有相当的理解，能够编写一定量的移植代码实现操作系统和底层硬件的连接。μC／OS—II是一种源代码公开的占先式实时操作系统内核，本文主要结合μC／OS—II的系统函数的应用，说明利用μC／OS—II系统函数的参数和返回值来提高程序设计效率和代码质量的方法。

1 参数和返回值分类
    通过对μC／0S—II的学习和研究，可以发现它提供的系统函数大多是用标准C语言写的；受C语言语法规则的限制，这些函数只有一个返回值。为了在使用μC／0SII的系统函数时得到更多的状态信息，将状态信息保存在函数参数中。这样，μC／OS—II系统函数的参数可以分为两类：第一类是普通的形式参数，这类参数符合传统的使用方法，主要传递实际参数的值，起到数值传递的作用；第二类形式参数在使用时，不传递有效数值，仅是一个变量。系统函数在执行时产生的状态信息就保存在第二类参数里，在系统函数调用结束时通过这类参数的值来查看系统函数执行过程中产生的状态信息。
    本文以函数0SSemPend()为例来介绍。这个函数没有返回值，它每个形式参数的具体含义见参考文献，这里不做具体的描述。其参数可归为上述的两类：OS_EVENT*pevent和INTl6U timeout为第一类，应用程序中的实际参数要给予它们具体的数值；INT8U*err为第二类，应用程序中的实际参数不需要给出具体的数值，在函数代码执行时，会根据不同的情况给INT8U*err赋值，这个值反映了函数的执行情况。如OSSemPend()函数的应用所示。

2 函数参数和返回值中的状态信息
    μC／OS—II的系统函数根据实际情况可以分为没有参数和返回值的函数、有参数没有返回值的函数和既有参数又有返回值的函数。在这里不讨论第一种情况，本文主要研究的是第二和第三种情况。如前所述，μC／OS—II为了增加系统函数执行产生的状态信息和返回值，将状态信息放到函数的参数中。笔者通过对μC／0S—II的系统函数的研究发现，这些函数并不是都将状态信息放到函数的参数中。有的也放到返回值中，如OSsemQtJery()函数，就是用返回值传递的状态信息，而用函数的参数传递的有效信息。这些状态信息反映了在使用μC／OS—II的系统函数时出现的问题，通过读这些状态可以知道系统函数执行的情况。因此，从安全的角度来说，在使用这些系统函数时应该读出所有状态信息，并且根据状态的不同给出相应的处理指令。按照这种思路，对OSSemPend()函数的应用的改进如下：

    可以看到，在调用系统服务函数OSSemPend()时，临时变量err作为实际参数传递给OSSemPend()。在执行这个函数后，err这个临时变量就包含了函数执行时产生的状态信息。这些状态信息使用常量而不用一个常数，是为了增加软件的可读性和通用性。具体的定义和含义如表1所列，其中前两种返回值是正常的：第一种是有信号可用时的情况，进行正常的处理；第二种是在规定的时间内没有信号到来，要做超时处理。后面三种情况是人为错误造成的。在调用OSSemPend()系统函数后要对这个包含状态信息的变量进行分析处理，过程如上述程序所示，由于篇幅关系，这里只是用简单的一句话来代表处理过程。