Skip to main content

XTaskQueueCreate

Cria uma fila de tarefas, que pode ser usada para enfileirar e expedir chamadas.

Sintaxe

Parâmetros

workDispatchMode   _In_
Tipo: XTaskQueueDispatchMode
O modo de expedição da porta de “trabalho” da fila. completionDispatchMode   _In_
Tipo: XTaskQueueDispatchMode
O modo de expedição da porta de “conclusão” da fila. queue   _Out_
Tipo: XTaskQueueHandle*
A fila recém-criada.

Valor retornado

Tipo: HRESULT Código de sucesso ou de erro HRESULT.

Comentários

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
Filas de tarefas são objetos com contagem de referências. Libere a referência chamando XTaskQueueCloseHandle. Uma fila de tarefas tem portas de trabalho e de conclusão, e as tarefas podem ser enfileiradas em qualquer uma delas. Cada porta pode ser configurada com seu próprio modo de expedição. Na maioria dos cenários, você cria uma fila de tarefas com a API XTaskQueueCreate. No entanto, se você estiver encadeando várias chamadas assíncronas, às vezes é útil criar uma fila composta por meio de XTaskQueueCreateComposite. Considere uma API cuja implementação precisa invocar outra API que usa uma fila de tarefas. Talvez você queira redirecionar o retorno de chamada de conclusão da API para que ele não ocupe o thread de conclusão do chamador. Nesse caso, você pode criar uma fila de tarefas composta cujas portas de trabalho e de conclusão são criadas a partir da porta de trabalho de outra fila. O exemplo a seguir cria uma fila de tarefas que expede retornos de chamada de trabalho e de conclusão no pool de threads do sistema.
SubmitCallback é uma função auxiliar definida no exemplo de código da função XTaskQueueSubmitCallback.
O exemplo a seguir cria uma fila de tarefas bombeada manualmente. Ele cria dois threads STL que expedem chamadas para as portas de trabalho e de conclusão.
SubmitCallback é uma função auxiliar definida no exemplo de código da função XTaskQueueSubmitCallback.

Requisitos

Cabeçalho: XTaskQueue.h Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

Membros de XTaskQueue
Modelo de programação assíncrona
Design da fila de tarefas assíncrona
Last modified on October 6, 2026