Skip to main content

XTaskQueueCreateComposite

Crea una cola de tareas compuesta por puertos de otras colas de tareas.

Sintaxis

Parámetros

workPort   _In_
Tipo: XTaskQueuePortHandle
El puerto que se usará para poner en cola las devoluciones de llamada de trabajo. completionPort   _In_
Tipo: XTaskQueuePortHandle
El puerto que se usará para poner en cola las devoluciones de llamada de finalización. queue   _Out_
Tipo: XTaskQueueHandle*
La cola recién creada.

Valor devuelto

Tipo: HRESULT Código de error o de éxito HRESULT.

Comentarios

No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte Subprocesos sensibles al tiempo.
Las colas de tareas son objetos con recuento de referencias. Libere la referencia llamando a XTaskQueueCloseHandle. Una cola de tareas tiene puertos de trabajo y de finalización, y las tareas se pueden poner en cola en cualquiera de los dos puertos. Cada puerto se puede configurar con su propio modo de distribución. En la mayoría de los escenarios, la cola de tareas se crea con la API XTaskQueueCreate. Sin embargo, si está encadenando varias llamadas asincrónicas, a veces resulta útil crear una cola compuesta mediante XTaskQueueCreateComposite. Considere una API cuya implementación necesita invocar otra API que usa una cola de tareas. Es posible que quiera redirigir la devolución de llamada de finalización de la API para que no bloquee el subproceso de finalización del autor de la llamada. En este caso, puede crear una cola de tareas compuesta cuyos puertos de trabajo y de finalización se crean a partir del puerto de trabajo de otra cola. En el ejemplo siguiente se crea una cola de tareas compuesta.

Requisitos

Encabezado: XTaskQueue.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

Miembros de XTaskQueue
Modelo de programación asincrónica
Diseño de la cola de tareas asincrónicas
Última modificación el 28 de agosto de 2026