Função KeSetBasePriorityThread (ntddk.h)

A rotina KeSetBasePriorityThread define a prioridade de tempo de execução, em relação ao processo atual, para um determinado thread.

Sintaxe

LONG KeSetBasePriorityThread(
  [in, out] PKTHREAD Thread,
  [in]      LONG     Increment
);

Parâmetros

[in, out] Thread

Ponteiro para um objeto dispatcher do tipo KTHREAD.

[in] Increment

Especifica o valor a ser adicionado à prioridade base do processo para o Thread.

Retornar valor

KeSetBasePriorityThread retorna o incremento de prioridade base anterior do thread fornecido. O incremento de prioridade base anterior é definido como a diferença entre a prioridade base antiga do thread especificado e a prioridade base do processo do thread.

Comentários

A nova prioridade base é calculada adicionando o Incremento fornecido, que pode ser um valor negativo, à prioridade base do processo do thread especificado. O valor resultante é armazenado como a prioridade base do thread especificado.

Os drivers que configuram threads dedicados ao dispositivo com atributos de prioridade variável podem chamar essa rotina para definir a prioridade desse thread em relação ao processo do sistema no qual o thread é criado.

A nova prioridade base é restrita à classe de prioridade do processo do thread fornecido. Portanto, a prioridade base não tem permissão para passar de uma classe de prioridade variável para uma classe de prioridade em tempo real ou vice-versa.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Universal
Cabeçalho ntddk.h (inclua Ntddk.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Confira também

KeGetCurrentThread

KeQueryPriorityThread

KeSetPriorityThread