Fonction InitializeThreadpoolEnvironment (winbase.h)
Initialise un environnement de rappel.
Syntaxe
void InitializeThreadpoolEnvironment(
[out] PTP_CALLBACK_ENVIRON pcbe
);
Paramètres
[out] pcbe
Structure TP_CALLBACK_ENVIRON qui définit un environnement de rappel.
Valeur de retour
None
Remarques
Par défaut, un rappel s’exécute dans le pool de threads par défaut pour le processus. Aucun groupe de nettoyage n’est associé à l’environnement de rappel, l’appelant est responsable du chargement de la DLL du rappel tant que des rappels sont en suspens, et le rappel est censé s’exécuter dans un délai raisonnable pour l’application.
Créez un environnement de rappel si vous envisagez d’appeler l’une des fonctions suivantes pour modifier l’environnement :
- SetThreadpoolCallbackCleanupGroup
- SetThreadpoolCallbackLibrary
- SetThreadpoolCallbackPool
- SetThreadpoolCallbackPriority
- SetThreadpoolCallbackRunsLong
- CreateThreadpoolIo
- CreateThreadpoolTimer
- CreateThreadpoolWait
- CreateThreadpoolWork
- TrySubmitThreadpoolCallback
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 | winbase.h (inclure Windows.h) |