You are here

FreeRTOS ИПП: xQueueAddToSet()

Перевод может содержать ошибки. Читайте первоисточник: FreeRTOS Queue Set API Functions - xQueueAddToSet()

Назад: [xQueueCreateSet()] Вверх: [ИПП: Наборы очередей] Вперёд: [xQueueRemoveFromSet()]

 

xQueueAddToSet()

Функция объявляется в файле queue.h

BaseType_t xQueueAddToSet
                      (
                          QueueSetMemberHandle_t xQueueOrSemaphore,
                          QueueSetHandle_t xQueueSet
                      );

Настройка configUSE_QUEUE_SETS в файле FreeRTOSConfig.h должна быть установлена в 1 для включения в код функций работы с наборами очередей.

Добавляет очередь или семафор в набор очередей, ранее созданный вызовом xQueueCreateSet().

Если очередь или семафор уже являются членом набора очередей, нельзя получать данные из очереди или забирать семафор до тех пор, пока xQueueSelectFromSet() не вернёт указатель на дескриптор этого члена.

Параметры

xQueueOrSemaphore Указатель на очередь или семафор, который будет добавлен к набору очередей (приводится к типу QueueSetMemberHandle_t).
xQueueSet Указатель на набор очередей, к котором будет добавлен новый член.

Возвращаемое значение

Если очередь или семафор успешно добавлены к набору очередей, возвращается значение pdPASS. Если очередь или семафор не могут быть добавлены к набору очередей, поскольку уже являются членом другого набора очередей, возвращается значение pdFAIL.

Пример использования

Пример использования находится на странице xQueueCreateSet() документации.

Hobby's category: