Skip to main content

XTaskQueueRegisterWaiter

向工作佇列註冊等候控制代碼。

語法

參數

queue   _In_
類型:XTaskQueueHandle
要提交回呼的佇列。 port   _In_
類型:XTaskQueuePort
要提交回呼的連接埠。回呼可以指派給工作連接埠或完成連接埠。 waitHandle   _In_
類型:HANDLE
要監視的控制代碼。
這是等候控制代碼,收到訊號時會導致叫用回呼。等候控制代碼通常是自動重設或手動重設事件。如果等候控制代碼是手動重設,只要事件處於已收到訊號狀態,就會重複叫用回呼。如果這不是您要的行為,請在回呼中重設事件,或取消註冊等候回呼。
callbackContext   _In_opt_
類型:void*
將傳遞給回呼的選擇性內容指標。 callback   _In_
類型:XTaskQueueCallback*
回呼函式的指標。 token   _Out_
類型:XTaskQueueRegistrationToken*
註冊權杖。可以將此權杖傳遞給 XTaskQueueUnregisterWaiter 以取消註冊等候。

傳回值

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

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
當等候控制代碼得到滿足時,工作佇列會叫用指定的回呼。這提供一種有效率的方式,可在控制代碼收到訊號時將項目加入工作佇列。 下列範例會向工作佇列註冊 Win32 核心控制代碼。當控制代碼收到訊號時,您的回呼就會提交至佇列。一般而言,您會建立自動重設事件來發出訊號。如果控制代碼不是自動重設,只要控制代碼處於已收到訊號狀態,每當目前的回呼完成時,就會提交新的回呼。

需求

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

概念文件

另請參閱

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