Skip to main content

XTaskQueueCreateComposite

Cria uma fila de tarefas composta por portas de outras filas de tarefas.

Sintaxe

Parâmetros

workPort   _In_
Tipo: XTaskQueuePortHandle
A porta a ser usada para enfileirar retornos de chamada de trabalho. completionPort   _In_
Tipo: XTaskQueuePortHandle
A porta a ser usada para enfileirar retornos de chamada de conclusão. 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 composta.

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