Функция KsQueueWorkItem (ks.h)

Статья
02/07/2025

Функция KsQueueWorkItem очереди указанного рабочего элемента с рабочей ролью, созданной функцией KsRegisterWorker.

Синтаксис

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

Параметры

[in] Worker

Указывает ранее выделенную рабочую роль.

[in] WorkItem

Указывает инициализированный рабочий элемент в очередь. Этот рабочий элемент связан только с рабочей ролью, если рабочий элемент находится в очереди. Рабочий элемент должен быть инициализирован IoAllocateWorkItem.

Возвращаемое значение

Функция KsQueueWorkIte m возвращает STATUS_SUCCESS, если рабочий элемент был помещен в очередь, или если функция не выполнена, возвращает ошибку при попытке создать новую рабочую роль, если потоки в настоящее время недоступны.

Замечания

Рабочая роль может находиться только в очереди в одном месте, поэтому последующие очереди рабочей роли должны ждать, пока рабочий элемент не начнет выполняться. Эта функция может вызываться в DISPATCH_LEVEL.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	ks.h (include Ks.h)
библиотеки	Ks.lib

Поделиться через