StartThreadpoolIo, fonction (threadpoolapiset.h)

Article
03/02/2024

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