KsQueueWorkItem 函式 (ks.h)

KsQueueWorkItem 函式會將指定的工作專案排入 KsRegisterWorker 函式先前建立的背景工作專案。

語法

KSDDKAPI NTSTATUS KsQueueWorkItem(
  [in] PKSWORKER        Worker,
  [in] PWORK_QUEUE_ITEM WorkItem
);

參數

[in] Worker

指定先前配置的背景工作角色。

[in] WorkItem

指定要排入佇列的初始化工作專案。 只要背景工作項目位於佇列中，此工作專案才會與背景工作角色相關聯。 工作項目必須由 IoAllocateWorkItem初始化。

傳回值

如果工作專案已排入佇列， KsQueueWorkItem 函式會傳回STATUS_SUCCESS;如果嘗試建立新的背景工作角色時，如果目前沒有可用的線程，則函式會傳回錯誤。

備註

背景工作角色只能位於一個位置的佇列上，因此背景工作角色的後續佇列必須等到工作專案開始執行為止。 此函式可以在 DISPATCH_LEVEL呼叫。

規格需求