0425

查询一个内存分区的状态，OSMemQuery()

1. 在µC/OS-II 中，可以使用OSMemQuery()函数来查询一个特定内存分区的有关消息。通过该函数可以知道特定内存分区中内存块的大小、可用内存块数和正在使用的内存块数等信息。所有这些信息都放在一个叫OS_MEM_DATA的数据结构中，如程序清单 L7.6。  
2.   
3. 程序清单 L7.6 OS_MEM_DATA数据结构  
4. typedef struct {  
5.     void  *OSAddr;     /* 指向内存分区首地址的指针 */  
6.     void  *OSFreeList; /* 指向空闲内存块链表首地址的指针 */  
7.     INT32U OSBlkSize;  /* 每个内存块所含的字节数 */  
8.     INT32U OSNBlks;    /* 内存分区总的内存块数 */  
9.     INT32U OSNFree;    /* 空闲内存块总数 */  
10.     INT32U OSNUsed;    /* 正在使用的内存块总数 */  
11. } OS_MEM_DATA;  
12.   
13. 程序清单 L7.7是OSMemQuery()函数的源代码，它将指定内存分区的信息复制到OS_MEM_DATA定义的变量的对应域中。在此之前，代码首先禁止了外部中断，防止复制过程中某些变量值被修改[L7.7(1)]。由于正在使用的内存块数是由OS_MEM_DATA中的局部变量计算得到的，所以，可以放在（critical section中断屏蔽）的外面。  
14.   
15. 程序清单 L7.7 OSMemQuery()  
16. INT8U OSMemQuery (OS_MEM *pmem, OS_MEM_DATA *pdata)  
17. {  
18.     OS_ENTER_CRITICAL();  
19.     pdata->OSAddr     = pmem->OSMemAddr;                       (1)  
20.     pdata->OSFreeList = pmem->OSMemFreeList;  
21.     pdata->OSBlkSize  = pmem->OSMemBlkSize;  
22.     pdata->OSNBlks    = pmem->OSMemNBlks;  
23.     pdata->OSNFree    = pmem->OSMemNFree;  
24.     OS_EXIT_CRITICAL();  
25.     pdata->OSNUsed    = pdata->OSNBlks - pdata->OSNFree;        (2)  
26.     return (OS_NO_ERR);  
27. }