> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XTaskQueueCallback

> XTaskQueueCallback

# XTaskQueueCallback

Una devolución de llamada que la cola de tareas invoca.

## Sintaxis

```cpp theme={null}
void XTaskQueueCallback(  
         void* context,  
         bool canceled  
)  
```

### Parámetros

*context*   \_In\_opt\_\
Tipo: void\*

Opcional. Un puntero de contexto que se pasa al llamar a [XTaskQueueSubmitCallback](/reference/system/xtaskqueue/functions/xtaskqueuesubmitcallback).

*canceled*   \_In\_\
Tipo: bool

Si es true, la devolución de llamada se está cancelando porque la cola de tareas está finalizando.

### Valor devuelto

Tipo: void

## Comentarios

La devolución de llamada `XTaskQueueCallback` se implementa para realizar trabajo en una cola de tareas. Las devoluciones de llamada se pueden enviar al puerto de trabajo o al puerto de finalización de una cola de tareas invocando [XTaskQueueSubmitCallback](/reference/system/xtaskqueue/functions/xtaskqueuesubmitcallback) o [XTaskQueueSubmitDelayedCallback](/reference/system/xtaskqueue/functions/xtaskqueuesubmitdelayedcallback). El puerto de trabajo y el puerto de finalización de una cola de tareas pueden tener modos de distribución independientes, y las devoluciones de llamada `XTaskQueueCallback` se pueden enviar a cualquiera de los dos puertos. Normalmente, una devolución de llamada enviada a un puerto de trabajo envía a su vez una devolución de llamada correspondiente al puerto de finalización al completar su trabajo.

El propósito del parámetro `canceled` es garantizar que los recursos asignados por una devolución de llamada se puedan liberar correctamente si se cancela una devolución de llamada. Si se llama a una devolución de llamada `XTaskQueueCallback` y `canceled` está establecido en true, la cola de tareas de esa devolución de llamada se ha finalizado llamando a [XTaskQueueTerminate](/reference/system/xtaskqueue/functions/xtaskqueueterminate) y la devolución de llamada se ha cancelado. La devolución de llamada debe liberar todos los recursos asignados, incluida la memoria asignada en `context`, y no realizar ningún otro trabajo.

Para ver un ejemplo, consulte [Envío de devoluciones de llamada](/build/core-features/common/async/async-task-queue-design-howto/submitting-callbacks).

## Requisitos

**Encabezado:** XTaskQueue.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Miembros de XTaskQueue](/reference/system/xtaskqueue/xtaskqueue_members)\
[Modelo de programación asincrónica](/build/core-features/common/async/async-programming-model)\
[Diseño de la cola de tareas asincrónicas](/build/core-features/common/async/async-task-queue-design)


## Related topics

- [XTaskQueueSubmitCallback](/es/reference/system/xtaskqueue/functions/xtaskqueuesubmitcallback.md)
- [XTaskQueueSubmitDelayedCallback](/es/reference/system/xtaskqueue/functions/xtaskqueuesubmitdelayedcallback.md)
- [XTaskQueue](/es/reference/system/xtaskqueue/xtaskqueue_members.md)
- [XTaskQueueRegisterWaiter](/es/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter.md)
- [Diseño de colas de tareas asincrónicas](/es/build/core-features/common/async/async-task-queue-design.md)