Compartilhar via


Função KsRegisterWorker (ks.h)

A função KsRegisterWorker manipula os clientes que se registram para uso de um thread. A função pode criar um novo thread da prioridade especificada se não houver threads gratuitos disponíveis no momento. Isso deve ser correspondido por um KsUnregisterWorker correspondente quando o uso do thread for concluído. A função só pode ser chamada em PASSIVE_LEVEL.

typedef PVOID PKSWORKER;

As rotinas de trabalho funcionam em objetos PKSWORKER opacos que são criados para cada item de trabalho enfileirado ao mesmo tempo.

Sintaxe

KSDDKAPI NTSTATUS KsRegisterWorker(
  [in]  WORK_QUEUE_TYPE WorkQueueType,
  [out] PKSWORKER       *Worker
);

Parâmetros

[in] WorkQueueType

Especifica a prioridade do thread a ser criado. Isso geralmente é CriticalWorkQueue, DelayedWorkQueue ou HyperCriticalWorkQueue.

[out] Worker

Local para colocar o contexto opaco que deve ser usado ao agendar um item de trabalho. Isso contém o tipo de fila e é usado para sincronizar a conclusão de itens de trabalho.

Valor de retorno

A função KsRegisterWorker retorna STATUS_SUCCESS se um trabalho foi inicializado ou se a função retorna um erro de thread ou parâmetro.

Requisitos

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