XTaskQueueSubmitDelayedCallback
將回呼提交至佇列的指定連接埠。語法
參數
queue _In_類型:XTaskQueueHandle 要提交回呼的佇列。 port _In_
類型:XTaskQueuePort 要提交回呼的連接埠。回呼可以指派給工作連接埠或完成連接埠。 delayMs _In_
類型:uint32_t 將回呼提交至佇列之前要延遲的毫秒數。
回呼可以提交為在未來某個時間加入佇列。如果 delayMs 不是零,回呼會放在擱置清單中,並以下一個最接近的等候時間初始化計時器。當時間經過後,具有下一個時間的回呼會放在執行清單中。佇列會引發 XTaskQueueMonitorCallback,而如果佇列以執行緒集區分派模式執行,則會提交執行緒集區工作。
類型:void* 將傳遞給回呼的選擇性內容指標。 callback _In_
類型:XTaskQueueCallback* 回呼函式的指標。
傳回值
類型:HRESULT HRESULT 成功或錯誤碼。備註
此回呼會在 delayMs 毫秒之後加入佇列。
將項目加入佇列必須是無鎖定且無等候的,以符合上游程式碼的效能需求。下列 API 為無鎖定:
- XTaskQueueSubmitCallback
- XTaskQueueSubmitDelayedCallback
- XTaskQueueDispatch,前提是 timeoutInMs 傳遞 0
SubmitCallback 是在 XTaskQueueSubmitCallback 函式的程式碼範例中定義的協助程式函式。
需求
標頭: XTaskQueue.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機另請參閱
XTaskQueue 成員非同步程式設計模型
非同步工作佇列設計
