Função NtSetInformationThread (ntifs.h)

A rotina de NtSetInformationThread define a prioridade de um thread.

Sintaxe

__kernel_entry NTSYSCALLAPI NTSTATUS NtSetInformationThread(
  [in] HANDLE          ThreadHandle,
  [in] THREADINFOCLASS ThreadInformationClass,
  [in] PVOID           ThreadInformation,
  [in] ULONG           ThreadInformationLength
);

Parâmetros

[in] ThreadHandle

Manipule para o objeto thread. Para criar um novo thread e obter um identificador para ele, chame PsCreateSystemThread. Para especificar o thread atual, use a macro ZwCurrentThread.

[in] ThreadInformationClass

Um dos valores definidos pelo sistema na enumeração THREADINFOCLASS (consulte ntddk.h), ThreadPriority, ThreadBasePriority, ThreadPagePriorityou ThreadPowerThrottlingState.

[in] ThreadInformation

Ponteiro para uma variável que especifica as informações a serem definidas.

Se ThreadInformationClass for threadPriority, esse valor deverá ser > LOW_PRIORITY e <= HIGH_PRIORITY.

Se ThreadInformationClass for threadBasePriority, esse valor deverá estar dentro do intervalo de prioridade base válido do sistema e da classe de prioridade original para o thread fornecido. Ou seja, se a classe de prioridade de um thread for variável, a prioridade base desse thread não poderá ser redefinida para um valor de prioridade em tempo real e vice-versa.

Se ThreadInformationClass for threadPagePriority, esse valor será um ponteiro para uma estrutura de PAGE_PRIORITY_INFORMATION, consulte ntddk.h. O PagePriority valor de membro deve ser um desses valores.

Se ThreadInformationClass for ThreadPowerThrottlingState, esse valor será um ponteiro para uma estrutura de POWER_THROTTLING_THREAD_STATE, consulte ntddk.h. O PagePriority valor de membro deve ser um desses valores.

[in] ThreadInformationLength

O tamanho, em bytes, de ThreadInformation.

Valor de retorno

NtSetInformationThread retorna STATUS_SUCCESS com êxito ou o código de erro NTSTATUS apropriado sobre falha. Os códigos de erro possíveis incluem STATUS_INFO_LENGTH_MISMATCH ou STATUS_INVALID_PARAMETER.

Observações

NtSetInformationThread podem ser chamados por drivers de nível superior para definir a prioridade de um thread para o qual eles têm um identificador.

O chamador deve ter THREAD_SET_INFORMATION direitos de acesso para o thread especificado para chamar essa rotina.

Normalmente, os drivers intermediários e de dispositivo que configuram threads criados pelo driver chamam KeSetBasePriorityThread ou keSetPriorityThread de seus threads criados pelo driver, em vez de chamar NtSetInformationThread. No entanto, um driver pode chamar NtSetInformationThread para aumentar a prioridade de um thread criado pelo driver antes que esse thread seja executado.

Os drivers de modo kernel podem chamar a função NtSetInformationThread com ThreadPagePriority para especificar a prioridade de página de um thread.

Para ajudar a melhorar o desempenho do sistema, os drivers devem usar a função com ThreadPagePriority para reduzir a prioridade de página de threads que executam operações em segundo plano ou acessam arquivos e dados que não devem ser acessados novamente em breve. Por exemplo, um aplicativo antimalware pode reduzir a prioridade dos threads envolvidos na verificação de arquivos.

Para chamadas de drivers no modo kernel, as versões NtXxx e Zwxxx versões de uma rotina dos Serviços de Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e Zwxxx de uma rotina, consulte Usando versões Nt e Zw das rotinas de serviços do sistema nativo..

Requisitos

Consulte também

KeSetBasePriorityThread

KeSetPriorityThread

PsCreateSystemThread

usando versões Nt e Zw das rotinas de serviços de sistema nativo.