xQueueAddToSet()
[队列集 API]
queue.h
BaseType_t xQueueAddToSet
(
QueueSetMemberHandle_t xQueueOrSemaphore,
QueueSetHandle_t xQueueSet
);
必须在 FreeRTOSConfig.h 中将 configUSE_QUEUE_SETS 设置为 1,这样 xQueueAddToSet () API 函数才可用。
将 RTOS 队列或信号量添加至先前由
xQueueCreateSet() 调用创建的队列集。
接收(如果是队列)或获取(如果是
信号量)操作,除非
调用 xQueueSelectFromSet() 先返回了队列集成员的句柄。
-
参数:
-
xQueueOrSemaphore
|
正在添加到队列集的队列或信号量的句柄
(转换为 QueueSetMemberHandle_t 类型)。
|
xQueueSet
|
正在添加队列或信号量的队列集句柄
。
|
-
返回:
-
如果队列或信号量成功添加到队列集
那么返回 pdPASS。 如果队列无法成功添加到
队列集,因为它已经是其他队列集的成员,那么返回 pdFAIL
。
用法示例:
请参阅 xQueueCreateSet() 文档页面上的示例。
Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.