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