Función CreateThreadpool (threadpoolapiset.h)
Asigna un nuevo grupo de subprocesos para ejecutar devoluciones de llamada.
Sintaxis
PTP_POOL CreateThreadpool(
PVOID reserved
);
Parámetros
reserved
Este parámetro está reservado y debe ser NULL.
Valor devuelto
Si la función se ejecuta correctamente, devuelve un puntero a una estructura de TP_POOL que representa el grupo de subprocesos recién asignado. Las aplicaciones no modifican los miembros de esta estructura.
Si se produce un error en la función, devuelve NULL. Para recuperar información de error extendida, llame a GetLastError.
Comentarios
Después de crear el nuevo grupo de subprocesos, debe llamar a SetThreadpoolThreadMaximum para especificar el número máximo de subprocesos que el grupo puede asignar y SetThreadpoolThreadMinimum para especificar el número mínimo de subprocesos disponibles en el grupo.
Para usar el grupo, debe asociar el grupo a un entorno de devolución de llamada. Para crear el entorno de devolución de llamada, llame a InitializeThreadpoolEnvironment. A continuación, llame a SetThreadpoolCallbackPool para asociar el grupo con el entorno de devolución de llamada.
Para liberar el grupo de subprocesos, llame a CloseThreadpool.
Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0600 o superior.
Ejemplos
Para obtener un ejemplo, consulte Uso de las funciones del grupo de subprocesos.
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 |