Compartilhar via

Função KsRegisterWorker (ks.h)

  • Artigo

A função KsRegisterWorker lida com clientes que se registram para uso de um thread. A função poderá criar um novo thread da prioridade especificada se não houver threads livres disponíveis no momento. Isso deve ser correspondido por um KsUnregisterWorker correspondente quando o uso do thread é 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.

Retornar valor

A função KsRegisterWorker retorna STATUS_SUCCESS se um trabalho foi inicializado ou, se não tiver êxito, a função retornará um erro de thread ou parâmetro.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho ks.h (inclua Ks.h)
Biblioteca Ks.lib