Skip to main content

XTaskQueueSubmitDelayedCallback

Envia um retorno de chamada para a fila na porta especificada.

Sintaxe

Parâmetros

queue   _In_
Tipo: XTaskQueueHandle
A fila para a qual enviar o retorno de chamada. port   _In_
Tipo: XTaskQueuePort
A porta para a qual enviar o retorno de chamada. Os retornos de chamada podem ser atribuídos a portas de trabalho ou de conclusão. delayMs   _In_
Tipo: uint32_t
O número de milissegundos de atraso antes de enviar o retorno de chamada para a fila.
Um retorno de chamada pode ser enviado para ser adicionado à fila em algum momento no futuro. Se delayMs for diferente de zero, o retorno de chamada será colocado em uma lista de pendentes e um temporizador será inicializado com o próximo tempo de espera mais próximo. Quando o tempo decorrer, o retorno de chamada com o próximo tempo será colocado na lista de execução. A fila gerará um XTaskQueueMonitorCallback e, se a fila estiver em execução em um modo de expedição de pool de threads, o trabalho do pool de threads será enviado.
callbackContext   _In_opt_
Tipo: void*
Um ponteiro de contexto opcional que será passado para o retorno de chamada. callback   _In_
Tipo: XTaskQueueCallback*
Um ponteiro para a função de retorno de chamada.

Valor retornado

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

Comentários

Este retorno de chamada será adicionado à fila após delayMs milissegundos. alert Observação de desempenho:
Adicionar um item a uma fila precisa ser livre de bloqueios e de esperas para atender aos requisitos de desempenho do código upstream. As seguintes APIs são livres de bloqueios:
O exemplo a seguir permite que retornos de chamada sejam enviados no futuro usando a função XTaskQueueSubmitDelayedCallback. Essa é uma ótima maneira de repetir uma chamada com falha após um curto atraso; também pode ser usada como um temporizador simples para eventos periódicos.
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

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