StartThreadpoolIo, fonction (threadpoolapiset.h)
Avertit le pool de threads que les opérations d’E/S peuvent éventuellement commencer pour l’objet d’achèvement d’E/S spécifié. Un thread de travail appelle la fonction de rappel de l’objet d’achèvement d’E/S une fois l’opération terminée sur le handle de fichier lié à cet objet.
Syntaxe
void StartThreadpoolIo(
[in, out] PTP_IO pio
);
Paramètres
[in, out] pio
Pointeur vers une structure de TP_IO qui définit l’objet d’achèvement d’E/S. La fonction CreateThreadpoolIo retourne ce pointeur.
Valeur de retour
None
Remarques
Vous devez appeler cette fonction avant de lancer chaque opération d’E/S asynchrone sur le handle de fichier lié à l’objet d’achèvement d’E/S. Si vous ne le faites pas, le pool de threads ignore une opération d’E/S à la fin de celle-ci et entraîne une altération de la mémoire.
Si l’opération d’E/S échoue, appelez la fonction CancelThreadpoolIo pour annuler cette notification.
Si le handle de fichier lié à l’objet d’achèvement d’E/S a le mode de notification FILE_SKIP_COMPLETION_PORT_ON_SUCCESS et qu’une opération d’E/S asynchrone retourne immédiatement avec succès, la fonction de rappel de fin d’E/S de l’objet n’est pas appelée et les notifications d’E/S du threadpool doivent être annulées. Pour plus d’informations, consultez CancelThreadpoolIo.
Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0600 ou une version ultérieure.
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 |