Skip to main content

XTaskQueueSetCurrentProcessTaskQueue

Define a fila de tarefas especificada como a fila de tarefas de todo o processo.

Sintaxe

Parâmetros

queue   _In_
Tipo: XTaskQueueHandle
A fila a ser configurada como a fila de tarefas padrão do processo.

Valor retornado

Tipo: void

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.
A fila pode ser definida como nullptr; nesse caso, XTaskQueueGetCurrentProcessTaskQueue também retornará nullptr. O identificador da fila fornecida será duplicado e o identificador de qualquer fila de tarefas do processo existente será fechado. O exemplo a seguir substitui a fila de tarefas padrão do processo. Essa fila de tarefas usa o pool de threads tanto para a expedição de trabalho quanto para a de conclusão. As APIs do Microsoft Game Development Kit (GDK) que recebem parâmetros de fila de tarefas aceitam nullptr e o substituem pela fila de tarefas do processo. A fila de tarefas do processo também pode ser definida como nullptr; nesse caso, as APIs do Microsoft Game Development Kit (GDK) que exigem um parâmetro de fila de tarefas retornarão o erro E_NO_TASK_QUEUE se um valor nulo for fornecido. Isso permite que as APIs do Microsoft Game Development Kit (GDK) funcionem com padrões e, ao mesmo tempo, permite um controle rigoroso sobre os identificadores de fila de tarefas, se necessário.

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