Función StartThreadpoolIo (threadpoolapiset.h)

  • Artículo

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

Vea también

CancelThreadpoolIo

CloseThreadpoolIo

CreateThreadpoolIo

Grupos de subprocesos

WaitForThreadpoolIoCallbacks