Skip to main content

XTaskQueueGetPort

Retorna o identificador da porta da fila de tarefas para a porta especificada.

Sintaxe

Parâmetros

queue   _In_
Tipo: XTaskQueueHandle
A fila de tarefas da qual obter a porta. port   _In_
Tipo: XTaskQueuePort
A porta a ser obtida. portHandle   _Out_
Tipo: XTaskQueuePortHandle*
O identificador da porta da fila de tarefas para a porta especificada.

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.
Os identificadores de porta da fila de tarefas pertencem à fila de tarefas e não precisam ser fechados. Eles são usados ao criar filas de tarefas compostas. O exemplo a seguir cria uma fila composta cujas portas de trabalho e de conclusão usam a porta de trabalho da fila original. Uma fila de tarefas composta é uma fila de tarefas formada por partes de outras filas. Filas de tarefas compostas são úteis quando uma tarefa assíncrona precisa chamar outra, e a conclusão dessa tarefa é uma etapa intermediária que não deve desperdiçar ciclos no thread 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