Skip to main content

XTaskQueueRegisterMonitor

Registra um retorno de chamada que será invocado sempre que um retorno de chamada for enviado para esta fila.

Sintaxe

Parâmetros

queue   _In_
Tipo: XTaskQueueHandle
A fila na qual registrar o retorno de chamada de envio. callbackContext   _In_opt_
Tipo: void*
Um ponteiro de contexto opcional a ser passado para o retorno de chamada de envio. callback   _In_
Tipo: XTaskQueueMonitorCallback*
Um retorno de chamada que será invocado quando um novo retorno de chamada for enviado para a fila. token   _Out_
Tipo: XTaskQueueRegistrationToken*
Um token usado ao chamar XTaskQueueUnregisterMonitor para remover o retorno de chamada.

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.
O exemplo a seguir mostra como uma fila de tarefas pode ser usada para sinalizar uma variável de condição quando tiver itens a expedir. Um aplicativo pode usar isso para compartilhar os threads que usa para a fila de tarefas com outros trabalhos do aplicativo.
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