B_QuRT_User_Guide(14)

8.12 qurt_signal_64_destroy()

8.12.1 功能文档

8.12.1.1 void qurt_signal_64_destroy ( qurt_signal_64_t ∗ signal )

销毁指定的信号对象。

注意：64 位信号对象在不再使用时必须销毁。  不这样做会导致 QuRT 内核中的资源泄漏。
    信号对象在仍在使用时不得销毁。  如果发生这种情况，则 QuRT 的行为是未定义的。

相关数据类型
qurt_signal_64_t

参数

in	signal	指向要销毁的信号对象的指针。

返回值
None.

依赖关系
None.

8.13 qurt_signal_64_wait()

8.13.1 功能文档

8.13.1.1 unsigned long long qurt_signal_64_wait ( qurt_signal_64_t ∗ signal,unsigned long long mask, unsigned int attribute )

挂起当前线程，直到设置了所有指定的信号。
信号表示为 64 位掩码值中的位 0 到 63。 掩码位值为 1 表示必须等待信号，而 0 表示不等待。
如果线程正在等待信号对象以设置所有指定的信号集，并且所有这些信号都设置在信号对象中，则线程被唤醒。

注意：在任何给定时间，一个线程最多可以等待一个信号对象。

相关数据类型
qurt_signal_64_t

参数

in	signal	指向要等待的信号对象的指针。
in	mask	掩码值，用于标识信号对象中要等待的各个信号
in	attribute	指示线程是否必须等待直到设置了任何信号，或者直到设置了所有信号。 注意：wait-any 和 wait-all 类型是互斥的。 值： QURT_SIGNAL_ATTR_WAIT_ANY QURT_SIGNAL_ATTR_WAIT_ALL

返回值
带当前信号的 32 位字。

依赖关系
None.

8.14 qurt_signal_64_set()

8.14.1 功能文档

8.14.1.1 void qurt_signal_64_set ( qurt_signal_64_t ∗ signal, unsigned long long mask )

在指定的信号对象中设置信号。
信号表示为 64 位掩码值中的位 0 到 63。 掩码位值为 1 表示必须设置信号，而 0 表示不设置。

相关数据类型
qurt_signal_64_t

参数

in	signal	指向要修改的信号对象的指针。
in	mask	标识要在信号对象中设置的各个信号的掩码值。

返回值
None.

依赖关系
None.

8.15 qurt_signal_64_get()

8.15.1 功能文档

8.15.1.1 unsigned long long qurt_signal_64_get ( qurt_signal_64_t ∗ signal )

从信号对象获取信号。
返回指定信号对象的当前信号值。

相关数据类型
qurt_signal_64_t

参数

in	∗signal	指向要访问的信号对象的指针。

返回值
带当前信号的 64 位双字。

依赖关系
None.

8.16 qurt_signal_64_clear()

8.16.1 功能文档

8.16.1.1 void qurt_signal_64_clear ( qurt_signal_64_t ∗ signal, unsigned long long mask )

清除指定信号对象中的信号。
信号表示为 64 位掩码值中的位 0 到 63。 屏蔽位值为 1 表示必须清除信号，为 0 表示不清除。

注意：信号必须在线程被唤醒时显式清除——等待操作不会自动清除它们。

相关数据类型
qurt_signal_64_t

参数

in	signal	指向要修改的信号对象的指针。
in	mask	标识信号对象中要清除的各个信号的掩码值。

返回值
None.

依赖关系
None.

8.17 Data Types

本节介绍信号服务的数据类型。

• 任意信号在 QuRT 中表示为 qurt_signal_t 类型的对象

8.17.1 Define Documentation

8.17.1.1 #define QURT_SIGNAL_ATTR_WAIT_ANY 0x00000000

暂无

8.17.1.2 #define QURT_SIGNAL_ATTR_WAIT_ALL 0x00000001

暂无

8.17.2 数据结构文档

8.17.2.1 union qurt_signal_t

QuRT 信号类型。

8.17.2.2 struct qurt_signal_64_t

QuRT 64 位信号类型。