Skip to main content

XTaskQueueSubmitDelayedCallback

將回呼提交至佇列的指定連接埠。

語法

參數

queue   _In_
類型:XTaskQueueHandle
要提交回呼的佇列。 port   _In_
類型:XTaskQueuePort
要提交回呼的連接埠。回呼可以指派給工作連接埠或完成連接埠。 delayMs   _In_
類型:uint32_t
將回呼提交至佇列之前要延遲的毫秒數。
回呼可以提交為在未來某個時間加入佇列。如果 delayMs 不是零,回呼會放在擱置清單中,並以下一個最接近的等候時間初始化計時器。當時間經過後,具有下一個時間的回呼會放在執行清單中。佇列會引發 XTaskQueueMonitorCallback,而如果佇列以執行緒集區分派模式執行,則會提交執行緒集區工作。
callbackContext   _In_opt_
類型:void*
將傳遞給回呼的選擇性內容指標。 callback   _In_
類型:XTaskQueueCallback*
回呼函式的指標。

傳回值

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

備註

此回呼會在 delayMs 毫秒之後加入佇列。 alert 效能注意事項:
將項目加入佇列必須是無鎖定且無等候的,以符合上游程式碼的效能需求。下列 API 為無鎖定:
下列範例使用 XTaskQueueSubmitDelayedCallback 函式,讓回呼可以在未來提交。這是在短暫延遲後重試失敗呼叫的絕佳方式;也可以用作定期事件的低成本計時器。
SubmitCallback 是在 XTaskQueueSubmitCallback 函式的程式碼範例中定義的協助程式函式。

需求

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

另請參閱

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