Share via

Функция 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