KsRegisterWorker 函式 (ks.h)
KsRegisterWorker 函式會處理註冊以使用線程的用戶端。 如果目前沒有可用的可用線程,此函式可以建立指定優先權的新線程。 當線程使用完成時,這必須由對應的 KsUnregisterWorker 進行比對。 函式只能在PASSIVE_LEVEL呼叫。
typedef PVOID PKSWORKER;
背景工作例程會在一次排入佇列的每個工作專案所建立的不透明 PKSWORKER 對象上運作。
語法
KSDDKAPI NTSTATUS KsRegisterWorker(
[in] WORK_QUEUE_TYPE WorkQueueType,
[out] PKSWORKER *Worker
);
參數
[in] WorkQueueType
指定要建立之線程的優先順序。 這通常是 CriticalWorkQueue、 DelayedWorkQueue 或 HyperCriticalWorkQueue。
[out] Worker
放置排程工作項目時必須使用之不透明內容的位置。 這包含佇列類型,並用來同步處理工作專案的完成。
傳回值
如果背景工作角色初始化,則 KsRegisterWorker 函式會傳回STATUS_SUCCESS,如果函式傳回線程或參數錯誤,則傳回失敗。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | ks.h (包含 Ks.h) |
程式庫 | Ks.lib |