Skip to main content

XTaskQueueRegisterWaiter

Registra um identificador de espera em uma fila de tarefas.

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. waitHandle   _In_
Tipo: HANDLE
O identificador a ser monitorado.
Este é o identificador de espera que, quando sinalizado, fará com que o retorno de chamada seja invocado. O identificador de espera normalmente é um evento de redefinição automática ou manual. Se o identificador de espera for de redefinição manual, o retorno de chamada será invocado repetidamente enquanto o evento estiver sinalizado. Se não for isso que você deseja, redefina o evento dentro do retorno de chamada ou cancele o registro do retorno de chamada de espera.
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. token   _Out_
Tipo: XTaskQueueRegistrationToken*
Um token de registro. Ele pode ser passado para XTaskQueueUnregisterWaiter para cancelar o registro da espera.

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.
Quando o identificador de espera é satisfeito, a fila de tarefas invoca o retorno de chamada especificado. Isso oferece uma maneira eficiente de adicionar itens a uma fila de tarefas em resposta à sinalização de identificadores. O exemplo a seguir registra um identificador de kernel Win32 em uma fila de tarefas. Seu retorno de chamada será enviado para a fila quando o identificador for sinalizado. Normalmente, você criaria um evento de redefinição automática para usar na sinalização. Se o identificador não for de redefinição automática, um novo retorno de chamada será enviado quando o retorno de chamada atual for concluído, enquanto o identificador permanecer sinalizado.

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