Função KsQueueWorkItem (ks.h)

A função KsQueueWorkItem enfileira o item de trabalho especificado com um trabalho criado anteriormente pela função KsRegisterWorker .

Sintaxe

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

Parâmetros

[in] Worker

Especifica o trabalho alocado anteriormente.

[in] WorkItem

Especifica o item de trabalho inicializado a ser enfileirado. Esse item de trabalho só está associado ao trabalho, desde que o trabalho esteja em uma fila. O item de trabalho deve ter sido inicializado por IoAllocateWorkItem.

Retornar valor

A função KsQueueWorkItem retornará STATUS_SUCCESS se o item de trabalho tiver sido enfileirado ou se a função não tiver êxito retornará um erro ao tentar criar um novo trabalho se nenhum thread estiver disponível no momento.

Comentários

O trabalhador só pode estar em uma fila em um só lugar, portanto, o enfileiramento subsequente do trabalho deve aguardar até que o item de trabalho tenha começado a ser executado. Essa função pode ser chamada em DISPATCH_LEVEL.

Requisitos