> ## 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.

# XTaskQueueCallback

> XTaskQueueCallback

# XTaskQueueCallback

由工作佇列叫用的回呼。

## 語法

```cpp theme={null}



void XTaskQueueCallback(  
         void* context,  
         bool canceled  
)  
```

### 參數

*context*   \_In\_opt\_\
類型：void\*

選擇性。呼叫 [XTaskQueueSubmitCallback](/zh-TW/reference/system/xtaskqueue/functions/xtaskqueuesubmitcallback) 時傳遞的內容指標。

*canceled*   \_In\_\
類型：bool

如果為 true，表示回呼因工作佇列正在終止而被取消。

### 傳回值

類型：void

## 備註

實作 `XTaskQueueCallback` 回呼以在工作佇列上執行工作。叫用 [XTaskQueueSubmitCallback](/zh-TW/reference/system/xtaskqueue/functions/xtaskqueuesubmitcallback) 或 [XTaskQueueSubmitDelayedCallback](/zh-TW/reference/system/xtaskqueue/functions/xtaskqueuesubmitdelayedcallback)，即可將回呼提交至工作佇列的工作連接埠或完成連接埠。工作佇列的工作連接埠和完成連接埠可以有獨立的分派模式，且 `XTaskQueueCallback` 回呼可以提交至任一連接埠。通常，提交至工作連接埠的回呼在完成其工作時，會接著將對應的回呼提交至完成連接埠。

`canceled` 參數的目的是確保在回呼被取消時，能夠正確釋放回呼所配置的任何資源。如果呼叫 `XTaskQueueCallback` 回呼時 `canceled` 設定為 true，表示該回呼的工作佇列已透過呼叫 [XTaskQueueTerminate](/zh-TW/reference/system/xtaskqueue/functions/xtaskqueueterminate) 終止，且回呼已被取消。回呼應釋放所有已配置的資源，包括在 `context` 中配置的記憶體，且不執行其他工作。

如需範例，請參閱[提交回呼](/zh-TW/build/core-features/common/async/async-task-queue-design-howto/submitting-callbacks)。

## 需求

**標頭：** XTaskQueue.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XTaskQueue 成員](/zh-TW/reference/system/xtaskqueue/xtaskqueue_members)\
[非同步程式設計模型](/zh-TW/build/core-features/common/async/async-programming-model)\
[非同步工作佇列設計](/zh-TW/build/core-features/common/async/async-task-queue-design)


## Related topics

- [XTaskQueueCallback](/reference/system/xtaskqueue/functions/xtaskqueuecallback.md)
- [XTaskQueueSubmitCallback](/reference/system/xtaskqueue/functions/xtaskqueuesubmitcallback.md)
- [XTaskQueueSubmitDelayedCallback](/reference/system/xtaskqueue/functions/xtaskqueuesubmitdelayedcallback.md)
- [XTaskQueue](/reference/system/xtaskqueue/xtaskqueue_members.md)
- [Async task queue design](/build/core-features/common/async/async-task-queue-design.md)