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调用此函数。

要求

要求 价值
目标平台 普遍
标头 ks.h (包括 Ks.h)
Ks.lib