XTaskQueueTerminate
Encerra uma fila de tarefas cancelando todos os itens pendentes e impedindo que novos itens sejam enfileirados.Sintaxe
Parâmetros
queue _In_Tipo: XTaskQueueHandle A fila a ser encerrada. wait _In_
Tipo: bool True para aguardar a conclusão do encerramento. callbackContext _In_opt_
Tipo: void* Um ponteiro de contexto opcional a ser passado para o retorno de chamada. callback _In_opt_
Tipo: XTaskQueueTerminatedCallback* Um retorno de chamada opcional que será chamado quando a fila for encerrada.
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.
- Todos os retornos de chamada das duas portas serão invocados com o parâmetro canceled definido como true.
- Todos os retornos de chamada pendentes na porta de trabalho serão expedidos. O envio de novos retornos de chamada para a porta de trabalho falhará com E_ABORT.
- Todos os retornos de chamada pendentes na porta de conclusão serão expedidos. O envio de novos retornos de chamada para a porta de conclusão falhará com E_ABORT.
- XTaskQueueTerminate não fecha o identificador da fila. Após o encerramento, você ainda precisa chamar XTaskQueueCloseHandle.
- Se você chamar XTaskQueueTerminate em um thread que está atendendo retornos de chamada da fila chamando XTaskQueueDispatch, não passe true para o parâmetro wait, ou seu código poderá entrar em deadlock.
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 SeriesDocumentação conceitual
Confira também
Membros de XTaskQueueModelo de programação assíncrona
Design da fila de tarefas assíncrona
