Skip to main content

XTaskQueueCreate

建立工作佇列,可用來將呼叫加入佇列並分派。

語法

參數

workDispatchMode   _In_
類型:XTaskQueueDispatchMode
佇列之「工作」連接埠的分派模式。 completionDispatchMode   _In_
類型:XTaskQueueDispatchMode
佇列之「完成」連接埠的分派模式。 queue   _Out_
類型:XTaskQueueHandle*
新建立的佇列。

傳回值

類型:HRESULT HRESULT 成功或錯誤碼。

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
工作佇列是參考計數物件。請呼叫 XTaskQueueCloseHandle 來釋放參考。 工作佇列具有工作連接埠和完成連接埠,而工作可以加入任一連接埠的佇列。每個連接埠都可以設定自己的分派模式。 在大多數情況下,您會使用 XTaskQueueCreate API 建立工作佇列。不過,如果您要將多個非同步呼叫鏈結在一起,有時透過 XTaskQueueCreateComposite 建立複合佇列會很有用。假設有一個 API,其實作需要叫用另一個使用工作佇列的 API。您可能想要重新導向該 API 的完成回呼,使其不會佔用呼叫端的完成執行緒。在此情況下,您可以建立一個複合工作佇列,其工作連接埠和完成連接埠都是從另一個佇列的工作連接埠建立而成。 下列範例會建立一個工作佇列,在系統執行緒集區上分派工作回呼和完成回呼。
SubmitCallback 是在 XTaskQueueSubmitCallback 函式的程式碼範例中定義的協助程式函式。
下列範例會建立一個手動推送的工作佇列。它會建立兩個 STL 執行緒,分別為工作連接埠和完成連接埠分派呼叫。
SubmitCallback 是在 XTaskQueueSubmitCallback 函式的程式碼範例中定義的協助程式函式。

需求

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

概念文件

另請參閱

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