> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Como: usar a fila de tarefas do processo

> Como: usar a fila de tarefas do processo

## Exemplo

A *fila de tarefas do processo* padrão usa o pool de threads para o despacho de trabalho e de conclusão. Todas 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. Ela pode ser substituída. 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 falharão com `E_NO_TASK_QUEUE`. Isso permite que as APIs do Microsoft Game Development Kit (GDK) funcionem com padrões e, ainda assim, possibilitem um controle rigoroso sobre os identificadores de fila de tarefas, se necessário.

O exemplo a seguir mostra como usar a fila de tarefas do processo.

```c++ theme={null}
void UsingProcessTaskQueue()  
{  
    XTaskQueueHandle queue = GetCurrentProcessTaskQueue();  
  
    auto callback = [](void*, bool)  
    {  
        printf("Work callback invoked.\r\n");  
    };  
  
    HRESULT hr = XTaskQueueSubmitCallback(  
        queue, XTaskQueuePort::Work,  
        nullptr, callback);  
  
    if (FAILED(hr))  
    {  
        printf("Failed to submit callback: %x\r\n", hr);  
        return;  
    }  
  
    // You can replace the process task queue.  
    hr = XTaskQueueCreate(  
        XTaskQueueDispatchMode::Manual,  
        XTaskQueueDispatchMode::Manual,  
        &queue);  
  
    if (FAILED(hr))  
    {  
        printf("Failed to create new task queue: %x\r\n", hr);  
        return;  
    }  
  
    XTaskQueueSetCurrentProcessTaskQueue(queue);  
  
    XTaskQueueHandle processQueue;  
    XTaskQueueGetCurrentProcessTaskQueue(&processQueue);  
    printf("Process task queue: %p. Our queue: %p\r\n",  
        processQueue, queue);  
    XTaskQueueCloseHandle(processQueue);  
  
    // You can set the process queue to nullptr to force everyone to pass a queue  
    // as a parameter.  
    XTaskQueueSetCurrentProcessTaskQueue(nullptr);  
    XTaskQueueGetCurrentProcessTaskQueue(&processQueue);  
    printf("Process task queue: %p.\r\n",  
        processQueue);  
}  
```

## Consulte também

[Projetando a fila de tarefas](/pt-BR/build/core-features/common/async/async-task-queue-design)


## Related topics

- [Design da fila de tarefas assíncronas](/pt-BR/build/core-features/common/async/async-task-queue-design.md)
- [Como: usar uma fila de tarefas com um loop de mensagens do Windows](/pt-BR/build/core-features/common/async/async-task-queue-design-howto/task-queue-windows-msg-loop.md)
- [Como: usar um waiter de fila de tarefas](/pt-BR/build/core-features/common/async/async-task-queue-design-howto/using-task-queue-waiter.md)
- [Como: criar uma fila de tarefas manual](/pt-BR/build/core-features/common/async/async-task-queue-design-howto/creating-manual-task-queue.md)
- [Como: Criar uma fila de tarefas composta](/pt-BR/build/core-features/common/async/async-task-queue-design-howto/creating-composite-task-queue.md)