Función WaitForThreadpoolIoCallbacks (threadpoolapiset.h)

Artículo
03/05/2024

Espera a que las devoluciones de llamada de finalización de E/S pendientes se completen y, opcionalmente, cancele las devoluciones de llamada pendientes que aún no se han iniciado para ejecutarse.

Sintaxis

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

Parámetros

[in, out] pio

Puntero a una estructura de TP_IO que define el objeto de finalización de E/S. La función CreateThreadpoolIo devuelve este puntero.

[in] fCancelPendingCallbacks

Indica si se cancelan las devoluciones de llamada en cola que aún no se han iniciado para ejecutarse.

Valor devuelto

None

Observaciones

Cuando fCancelPendingCallbacks se establece en TRUE, solo se cancelan las devoluciones de llamada en cola. Las solicitudes de E/S pendientes no se cancelan. Por lo tanto, el autor de la llamada debe llamar a GetOverlappedResult para la estructura SUPERPUESTA para comprobar si la operación de E/S se ha completado antes de liberar la estructura. Como alternativa, establezca fCancelPendingCallbacks en FALSE y que la devolución de llamada de finalización de E/S asociada libere la estructura SUPERPUESTA . Tenga cuidado de no liberar la estructura SUPERPUESTA mientras las solicitudes de E/S siguen pendientes; use GetOverlappedResult para determinar el estado de la operación de E/S y esperar a que se complete la operación. Opcionalmente, la función CancelIoEx se puede usar primero para cancelar las solicitudes de E/S pendientes, lo que podría acortar la espera. Para obtener más información, consulte Cancelación de operaciones de E/S pendientes.

Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0600 o superior.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	threadpoolapiset.h (incluya Windows.h en Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

Grupos de subprocesos