Skip to main content

XTaskQueueCallback

由工作佇列叫用的回呼。

語法

參數

context   _In_opt_
類型:void*
選擇性。呼叫 XTaskQueueSubmitCallback 時傳遞的內容指標。 canceled   _In_
類型:bool
如果為 true,表示回呼因工作佇列正在終止而被取消。

傳回值

類型:void

備註

實作 XTaskQueueCallback 回呼以在工作佇列上執行工作。叫用 XTaskQueueSubmitCallback 或 XTaskQueueSubmitDelayedCallback,即可將回呼提交至工作佇列的工作連接埠或完成連接埠。工作佇列的工作連接埠和完成連接埠可以有獨立的分派模式,且 XTaskQueueCallback 回呼可以提交至任一連接埠。通常,提交至工作連接埠的回呼在完成其工作時,會接著將對應的回呼提交至完成連接埠。 canceled 參數的目的是確保在回呼被取消時,能夠正確釋放回呼所配置的任何資源。如果呼叫 XTaskQueueCallback 回呼時 canceled 設定為 true,表示該回呼的工作佇列已透過呼叫 XTaskQueueTerminate 終止,且回呼已被取消。回呼應釋放所有已配置的資源,包括在 context 中配置的記憶體,且不執行其他工作。 如需範例,請參閱提交回呼。

需求

標頭: XTaskQueue.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

XTaskQueue 成員
非同步程式設計模型
非同步工作佇列設計
Last modified on October 6, 2026