Skip to main content

XTaskQueueRegisterMonitor

註冊一個回呼,每當有回呼提交至此佇列時就會叫用該回呼。

語法

參數

queue   _In_
類型:XTaskQueueHandle
要註冊提交回呼的佇列。 callbackContext   _In_opt_
類型:void*
要傳遞給提交回呼的選擇性內容指標。 callback   _In_
類型:XTaskQueueMonitorCallback*
當有新的回呼提交至佇列時將叫用的回呼。 token   _Out_
類型:XTaskQueueRegistrationToken*
呼叫 XTaskQueueUnregisterMonitor 以移除回呼時使用的權杖。

傳回值

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

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
下列範例示範工作佇列在有項目要分派時,如何用來發出條件變數的訊號。應用程式可以利用此方式,將用於工作佇列的執行緒與應用程式中的其他工作共用。
SubmitCallback 是在 XTaskQueueSubmitCallback 函式的程式碼範例中定義的協助程式函式。

需求

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

概念文件

另請參閱

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