XTaskQueueCallback
Una devolución de llamada que la cola de tareas invoca.Sintaxis
Parámetros
context _In_opt_Tipo: void* Opcional. Un puntero de contexto que se pasa al llamar a 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: voidComentarios
La devolución de llamadaXTaskQueueCallback 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 o 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 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.
Requisitos
Encabezado: XTaskQueue.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX SeriesConsulte también
Miembros de XTaskQueueModelo de programación asincrónica
Diseño de la cola de tareas asincrónicas