Функция предназначена для удаления очереди сообщений. Поле id_dque очереди dque после выполнения сервиса устанавливается в 0.

Все задачи, ожидающие сообщения или ожидающие освобождения очереди будут переведены в состояние готовности к выполнению - сервисы приема и отсылки сообщения вернут код TERR_DLT.

Вызов:

TN_RETVAL tn_queue_delete (TN_DQUE *dque);

Разрешен вызов:

В контексте задачи

Параметры функции:

dque

указатель на очередь сообщений

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

TERR_WRONG_PARAM

некорректное значение параметра ¹⁾

TERR_NOEXS

попытка удаления объекта, не являющегося очередью сообщений ²⁾

TERR_WCONTEXT

вызов функции из пользовательской критической секции или из обработчика прерывания

TERR_NO_ERR

успешное выполнение

Пример вызова:

TN_DQUE  queue TN_DATA;
 
tn_queue_delete(&queue);

К списку сервисов