Skip to main content

XTaskQueueCreate

Crea una cola de tareas, que se puede usar para poner en cola y distribuir llamadas.

Sintaxis

Parámetros

workDispatchMode   _In_
Tipo: XTaskQueueDispatchMode
El modo de distribución para el puerto de “trabajo” de la cola. completionDispatchMode   _In_
Tipo: XTaskQueueDispatchMode
El modo de distribución para el puerto de “finalización” de la cola. 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 que distribuye las devoluciones de llamada de trabajo y de finalización en el grupo de subprocesos del sistema.
SubmitCallback es una función auxiliar que se define en el ejemplo de código de la función XTaskQueueSubmitCallback.
En el ejemplo siguiente se crea una cola de tareas de distribución manual. Crea dos subprocesos STL que distribuyen las llamadas para los puertos de trabajo y de finalización.
SubmitCallback es una función auxiliar que se define en el ejemplo de código de la función XTaskQueueSubmitCallback.

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