— максимальное число потоков, которые допустимо иметь в блокированном состоянии. Если после завершения обработки некоторым потоком число заблокированных потоков становится больше , то этот поток уничтожается.

— общая верхняя граница числа потоков пула (активизированных и заблокированных). Даже если число заблокированных потоков (в пике активности) станет ниже , но общее число потоков уже достигнет maximum, то новые потоки для пула создаваться не будут.

Функциональные параметры пула определяют:

и — функции создания и уничтожения контекста потока, которые вызываются при создании и уничтожении каждого потока пула. Функция создания контекста потока ответственна за индивидуальные настройки создаваемого потока. Она возвращает «указатель на контекст» типа . Однако системе такой тип неизвестен:

В качестве контекста может использоваться любой пользовательский тип, и он будет передаваться последовательно в качестве параметра (

) во все последующие функции обслуживания потока.

— функция блокирования, которая вызывается в потоке сразу же после или после очередного этапа выполнения потоком функции обработчика . Функция блокирования получает и возвращает далее обработчику (возможно, после модификации) структуру контекста (в приведенном выше примере контекстом является  — значение присоединенного TCP-сокета).

— это, собственно, и есть аналог потоковой функции, в которой выполняется вся полезная работа потока. Функция вызывается библиотекой после выхода потока из блокирующей функции , при этом функция-обработчик получит параметр контекста, возвращенный .

2. После создания атрибутной записи пула, определяющей всю функциональность его дальнейшего поведения, можно приступать к непосредственному созданию пула потоков:

где

— подробно рассмотренная (и созданная) ранее атрибутная запись пула;

— флаг, определяющий поведение вызывающего потока после последующего вызова . В документации описано два возможных значения флага:

 • 

— после старта пула поток, вызвавший (часто это главный поток приложения), завершается;

 • 

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

И в том и в другом случае в типовом фрагменте (как и в показанном выше примере):

управление никогда не дойдет до выполнения exit(). Но существует еще третье допустимое значение, прямо не указанное в документации, но мельком упоминаемое в других местах документации:

 • 

— после старта пула поток, вызвавший , продолжает свое естественное выполнение.

Например, некоторый фрагмент кода мог бы выглядеть так:

Как уже понятно из описаний,

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

3. Последний шаг в процедуре запуска пула потоков:

где

— это указатель, возвращаемый . [40]

При успешном завершении (которого почти никогда не происходит, за исключением значения флага

; об этом см. выше) функция возвращает , в противном случае (что происходит гораздо чаще) — значение .

4. Другие, относящиеся к библиотеке динамического пула потоков функции, которые целесообразно посмотреть в документации QNX (но которые в силу различных обстоятельств используются гораздо реже):