Compartir a través de

Función KsQueueWorkItem (ks.h)

  • Artículo

La función KsQueueWorkItem pone en cola el elemento de trabajo especificado con un trabajo creado anteriormente por la función KsRegisterWorker .

Sintaxis

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

Parámetros

[in] Worker

Especifica el trabajo asignado anteriormente.

[in] WorkItem

Especifica el elemento de trabajo inicializado que se va a poner en cola. Este elemento de trabajo solo está asociado al trabajo siempre y cuando el trabajo esté en una cola. IoAllocateWorkItem debe haber inicializado el elemento de trabajo.

Valor devuelto

La función KsQueueWorkItem devuelve STATUS_SUCCESS si el elemento de trabajo se puso en cola, o si no se realiza correctamente, la función devuelve un error al intentar crear un nuevo trabajo si no hay subprocesos disponibles actualmente.

Comentarios

El trabajo solo puede estar en una cola en un solo lugar, por lo que la puesta en cola posterior del trabajo debe esperar hasta que el elemento de trabajo haya comenzado a ejecutarse. Se puede llamar a esta función en DISPATCH_LEVEL.

Requisitos

Requisito Value
Plataforma de destino Universal
Encabezado ks.h (incluye Ks.h)
Library Ks.lib