Partager via


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

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête threadpoolapiset.h (inclure Windows.h sur Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

CloseThreadpool

SetThreadpoolThreadMaximum

SetThreadpoolThreadMinimum

Pools de threads