Fonction WaitForThreadpoolIoCallbacks (threadpoolapiset.h)

Article
08/26/2023

Attend que les rappels d’achèvement d’E/S en attente se terminent et annule éventuellement les rappels en attente qui n’ont pas encore commencé à s’exécuter.

Syntaxe

void WaitForThreadpoolIoCallbacks(
  [in, out] PTP_IO pio,
  [in]      BOOL   fCancelPendingCallbacks
);

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.

[in] fCancelPendingCallbacks

Indique s’il faut annuler les rappels mis en file d’attente qui n’ont pas encore commencé à s’exécuter.

Valeur de retour

None

Remarques

Lorsque fCancelPendingCallbacks a la valeur TRUE, seuls les rappels en file d’attente sont annulés. Les demandes d’E/S en attente ne sont pas annulées. Par conséquent, l’appelant doit appeler GetOverlappedResult pour la structure OVERLAPPED afin de case activée si l’opération d’E/S est terminée avant de libérer la structure. En guise d’alternative, définissez fCancelPendingCallbacks sur FALSE et le rappel d’achèvement d’E/S associé libère la structure CHEVAUCHEMENT. Veillez à ne pas libérer la structure chevauchement tant que les demandes d’E/S sont toujours en attente ; utilisez GetOverlappedResult pour déterminer la status de l’opération d’E/S et attendre que l’opération se termine. La fonction CancelIoEx peut éventuellement être utilisée en premier pour annuler les demandes d’E/S en suspens, ce qui raccourcit potentiellement l’attente. Pour plus d’informations, consultez Annulation des opérations d’E/S en attente.

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