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

Voir aussi

CancelThreadpoolIo

CloseThreadpoolIo

CreateThreadpoolIo

Pools de threads

WaitForThreadpoolIoCallbacks