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 |