CreateThreadpool, fonction (threadpoolapiset.h)

Alloue un nouveau pool de threads pour exécuter des rappels.

Syntaxe

PTP_POOL CreateThreadpool(
  PVOID reserved
);

Paramètres

reserved

Ce paramètre est réservé et doit avoir la valeur NULL.

Valeur retournée

Si la fonction réussit, elle retourne un pointeur vers une structure TP_POOL représentant le pool de threads nouvellement alloué. Les applications ne modifient pas les membres de cette structure.

En cas d’échec de la fonction, elle retourne NULL. Pour récupérer des informations d’erreur étendues, appelez GetLastError.

Remarques

Après avoir créé le pool de threads, vous devez appeler SetThreadpoolThreadMaximum pour spécifier le nombre maximal de threads que le pool peut allouer et SetThreadpoolThreadMinimum pour spécifier le nombre minimal de threads disponibles dans le pool.

Pour utiliser le pool, vous devez associer le pool à un environnement de rappel. Pour créer l’environnement de rappel, appelez InitializeThreadpoolEnvironment. Ensuite, appelez SetThreadpoolCallbackPool pour associer le pool à l’environnement de rappel.

Pour libérer le pool de threads, appelez CloseThreadpool.

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0600 ou une version ultérieure.

Exemples

Pour obtenir un exemple, consultez Utilisation des fonctions de pool de threads.

Configuration requise

Voir aussi

CloseThreadpool

SetThreadpoolThreadMaximum

SetThreadpoolThreadMinimum

Pools de threads