B_QuRT_User_Guide(18)

11.6 qurt_sem_init_val()

11.6.1 Function Documentation

11.6.1.1 void qurt_sem_init_val ( qurt_sem_t ∗ sem, unsigned short val )

用指定的值初始化一个semaphore对象。
相关数据类型
qurt_sem_t
参数

返回值
None.
依赖关系
None.

11.7 qurt_sem_try_down()

11.7.1 Function Documentation

11.7.1.1 int qurt_sem_try_down ( qurt_sem_t ∗ sem )

请求访问一个共享资源（没有暂停）。当一个线程对一个
时，其结果取决于semaphore的计算值。

• 当计数值为非零时，会被递减。Down操作返回0作为函数结果，线程获得对共享资源的访问权，并可以继续执行。
• 当计数值为零时，不会被递减。下线操作返回-1作为函数结果，线程不能获得对共享资源的访问权，不应继续执行。
  相关数据类型
  qurt_sem_t
  参数
  
  返回值
  0 – Success. -1 – Failure.
  依赖关系
  None.

11.8 qurt_sem_up()

11.8.1 Function Documentation

11.8.1.1 static int qurt_sem_up ( qurt_sem_t ∗ sem )

释放对一个共享资源的访问。当一个线程在一个semaphore上执行向上操作时，semaphore的计数值会被增加。其结果取决于在该信号上等待的线程的数量。

• 当没有线程在等待时，当前线程释放对共享资源的访问并继续执行。
• 当有一个或多个线程在等待，并且semaphore的数值非零时，内核会唤醒优先级最高的等待线程，并递减semaphore的数值。如果被唤醒的线程比当前线程有更高的优先级，那么就会发生上下文切换。

相关数据类型
qurt_sem_t
参数

返回值
Unused integer value.
依赖关系
None.

11.9 qurt_sem_down_timed()

11.9.1 Function Documentation

11.9.1.1 int qurt_sem_down_timed ( qurt_sem_t ∗ sem, unsigned long long int duration )

当一个线程对一个信号灯进行向下操作时，其结果取决于信号灯的计数值。

• 当计数值为非零时，它被递减，线程获得对共享资源的访问权并继续执行。
• 当计数值为零时，它不会被递减，线程在信号灯上被暂停。当计数值变为非零时（因为另一个线程释放了该信号），它被递减，被暂停的线程被唤醒并获得对共享资源的访问。当指定的超时时间过后，终止等待。如果超时过后，终止该等待并不授予对共享资源的访问权。
  相关数据类型
  qurt_sem_t
  参数
  
  返回值
  QURT_EOK – Success QURT_ETIMEDOUT – Timeout
  依赖关系
  None.

11.10 Data Types

本节描述了信号灯服务的数据类型。

• 在QuRT中，semaphores被表示为qurt_sem_t类型的对象。

11.10.1 Data Structure Documentation

11.10.1.1 union qurt_sem_t

QuRT信号类型。