Функция переводит в состояние готовности самый приоритетный поток из блокированных на условной переменной

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

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

— успешное завершение;

— произошла ошибка при попытке обращения к указателям или ;

— не инициализирована переменная, на которую указывает .

Вызов функции разблокирует все потоки, блокированные на условной переменной

. Потоки разблокируются в порядке приоритетов. Для потоков равного приоритета разблокирование проводится в порядке FIFO.

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

— успешное завершение;

— произошла ошибка при попытке обращения к указателям или ;

— не инициализирована переменная, на которую указывает .

Вызов функции деинициализирует условную переменную

. Для дальнейшего использования условной переменной, на которую ссылается , ее необходимо инициализировать вызовом . Функция может использоваться для изменения параметров условной переменной.

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

— успешное завершение;

— в данный момент другой поток блокирован на условной переменной ;

— не инициализирована переменная .

QNX предоставляет упрощенный вариант использования условной переменной для блокирования (остановки) потока при помощи интерфейса так называемой ждущей блокировки( sleepon). Для использования этого механизма не нужно явно создавать никаких объектов синхронизации, за вас это делает ОС. Внешне ждущие блокировки выглядят как набор функций ожидания и освобождения, при этом последовательность действий в принципе аналогична использованию мьютексов и условных переменных.

За этим интерфейсом на самом деле скрывается один мьютекс и несколько дополнительных условных переменных. Использование функций ожидания должно проходить внутри участка кода, отмеченного вызовами блокирования и разблокирования мьютекса, ассоциированного со ждущей блокировкой. Одним из основных недостатков ждущей блокировки является то, что для всех потоков и всех ключей ожидания используется один общий мьютекс. ОС не может никоим образом отслеживать взаимные блокировки потоков при использовании ждущих блокировок. В целом поведение этого средства синхронизации идентично бинарным семафорам, но оно требует дополнительных операций блокирования мьютекса.

Все функции для работы со ждущими блокировками объявлены в файле

.

Вызов функций ожидания может производиться только внутри блока захвата и освобождения ждущей блокировки:

Функция захвата

возвращает следующие значения:

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

— попытка повторного захвата мьютекса;

— может возникнуть при первом вызове в процессе, если системе не хватает ресурсов для создания внутреннего мьютекса.

Функция освобождения

возвращает значения:

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

— вызвавший поток не является владельцем внутреннего мьютекса.

Ожидание выполнения условия для ждущей блокировки может выполняться в двух вариантах: простое ожидание и ожидание с установкой тайм-аута.

При вызове функций ожидания необходимо указать ключ

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