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

# 操作說明：使用處理序工作佇列

> 操作說明：使用處理序工作佇列

## 範例

預設的*處理序工作佇列*會使用執行緒集區進行工作分派和完成分派。接受工作佇列參數的 Microsoft Game Development Kit (GDK) API 全都接受 `nullptr`，並以處理序工作佇列取代。處理序工作佇列可以被取代，也可以設定為 `nullptr`。在此情況下，需要工作佇列參數的 Microsoft Game Development Kit (GDK) API 會傳回 `E_NO_TASK_QUEUE` 錯誤。這可讓 Microsoft Game Development Kit (GDK) API 使用預設值運作，同時仍可在需要時嚴密控制工作佇列控制代碼。

下列範例示範如何使用處理序工作佇列。

```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);  
}  
```

## 另請參閱

[設計工作佇列](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-task-queue-design.md)


## Related topics

- [操作說明：搭配 Windows 訊息迴圈使用工作佇列](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-task-queue-design-howto/task-queue-windows-msg-loop.md)
- [操作說明：使用工作佇列等候程式](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-task-queue-design-howto/using-task-queue-waiter.md)
- [非同步工作佇列設計](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-task-queue-design.md)
- [操作說明：建立手動工作佇列](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-task-queue-design-howto/creating-manual-task-queue.md)
- [操作說明：複製工作佇列控制代碼](https://docs.xbox.com/zh-TW/build/core-features/common/async/async-task-queue-design-howto/duplicating-task-queue-handle.md)