XTaskQueueCallback
Um retorno de chamada invocado pela fila de tarefas.Sintaxe
Parâmetros
context _In_opt_Tipo: void* Opcional. Um ponteiro de contexto passado ao chamar XTaskQueueSubmitCallback. canceled _In_
Tipo: bool Se for true, o retorno de chamada está sendo cancelado porque a fila de tarefas está sendo encerrada.
Valor retornado
Tipo: voidComentários
O retorno de chamadaXTaskQueueCallback é implementado para executar trabalho em uma fila de tarefas. Os retornos de chamada podem ser enviados para a porta de trabalho ou para a porta de conclusão de uma fila de tarefas invocando XTaskQueueSubmitCallback ou XTaskQueueSubmitDelayedCallback. A porta de trabalho e a porta de conclusão de uma fila de tarefas podem ter modos de expedição independentes, e os retornos de chamada XTaskQueueCallback podem ser enviados para qualquer uma das portas. Normalmente, um retorno de chamada enviado para uma porta de trabalho, por sua vez, envia um retorno de chamada correspondente para a porta de conclusão ao concluir seu trabalho.
A finalidade do parâmetro canceled é garantir que todos os recursos alocados por um retorno de chamada possam ser liberados corretamente se um retorno de chamada for cancelado. Se um retorno de chamada XTaskQueueCallback for chamado e canceled estiver definido como true, a fila de tarefas desse retorno de chamada foi encerrada pela chamada a XTaskQueueTerminate e o retorno de chamada foi cancelado. O retorno de chamada deve liberar todos os recursos alocados, incluindo a memória alocada em context, e não executar nenhum outro trabalho.
Para obter um exemplo, consulte Enviando retornos de chamada.
Requisitos
Cabeçalho: XTaskQueue.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX SeriesConfira também
Membros de XTaskQueueModelo de programação assíncrona
Projetando a fila de tarefas