Función StartThreadpoolIo (threadpoolapiset.h)
Notifica al grupo de subprocesos que las operaciones de E/S pueden comenzar posiblemente para el objeto de finalización de E/S especificado. Un subproceso de trabajo llama a la función de devolución de llamada del objeto de finalización de E/S una vez completada la operación en el identificador de archivo enlazado a este objeto.
Sintaxis
void StartThreadpoolIo(
[in, out] PTP_IO pio
);
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.
Valor devuelto
None
Observaciones
Debe llamar a esta función antes de iniciar cada operación de E/S asincrónica en el identificador de archivo enlazado al objeto de finalización de E/S. Si no lo hace, el grupo de subprocesos omitirá una operación de E/S cuando se complete y provocará daños en la memoria.
Si se produce un error en la operación de E/S, llame a la función CancelThreadpoolIo para cancelar esta notificación.
Si el identificador de archivo enlazado al objeto de finalización de E/S tiene el modo de notificación FILE_SKIP_COMPLETION_PORT_ON_SUCCESS y una operación de E/S asincrónica vuelve inmediatamente con éxito, no se llama a la función de devolución de llamada de finalización de E/S del objeto y se deben cancelar las notificaciones de E/S del grupo de subprocesos. Para obtener más información, vea CancelThreadpoolIo.
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 |