Función KsQueueWorkItem (ks.h)

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 que el trabajo esté en una cola. El elemento de trabajo debe haberse inicializado mediante IoAllocateWorkItem.

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.

Observaciones

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	Valor
de la plataforma de destino de	Universal
encabezado de	ks.h (incluya Ks.h)
biblioteca de	Ks.lib