Função KsQueueWorkItem (ks.h)

Artigo
02/07/2025

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 na fila. Esse item de trabalho só está associado ao trabalho, desde que o trabalhador esteja em uma fila. O item de trabalho deve ter sido inicializado IoAllocateWorkItem.

Valor de retorno

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

Observações

O trabalhador só pode estar em uma fila em um só lugar, portanto, a 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

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	ks.h (incluir Ks.h)
biblioteca	Ks.lib

Compartilhar via