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 |