KsRegisterCountedWorker 函式 (ks.h)

處理註冊以使用線程的用戶端。

語法

KSDDKAPI NTSTATUS KsRegisterCountedWorker(
  [in]  WORK_QUEUE_TYPE  WorkQueueType,
  [in]  PWORK_QUEUE_ITEM CountedWorkItem,
  [out] PKSWORKER        *Worker
);

參數

[in] WorkQueueType

包含工作線程的優先順序。 這通常是下列其中一項：CriticalWorkQueue、DelayedWorkQueue 或 HyperCriticalWorkQueue。

[in] CountedWorkItem

包含工作佇列專案的指標，此項目會視需要根據目前的計數值排入佇列。

[out] Worker

包含排程工作項目時必須使用的不透明內容。 也包含佇列類型，並用來同步處理工作專案的完成。

傳回值

如果背景工作角色已初始化，則傳回STATUS_SUCCESS。

備註

當線程使用完成時，這必須由對應的 KsUnregisterWorker 進行比對。 此函式類似於 KsRegisterWorker，並新增將一律排入佇列的工作專案。 這是要與 KsIncrementCountedWorker 和 KsDecrementCountedWorker 搭配使用，以便將已排入佇列的工作項目數目降至最低，並減少針對多個工作專案線程串行化存取所需的工作專案所需的相互排除程式代碼。 背景工作佇列仍可用來將其他工作專案排入佇列。 這隻能在PASSIVE_LEVEL呼叫。

規格需求

需求	值
目標平台	Universal
標頭	ks.h (包含 Ks.h)
程式庫	Ks.lib