Função ZwSetInformationThread (ntddk.h)

Artigo
02/07/2025

A rotina de ZwSetInformationThread define a prioridade de um thread.

Sintaxe

NTSYSAPI NTSTATUS ZwSetInformationThread(
  [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 POWER_THROTTLING_THREAD_STATE, consulte ntddk.h. O PagePriority valor de membro deve ser um desses valores.

Valor	Significado
MEMORY_PRIORITY_VERY_LOW	Prioridade de memória muito baixa.
MEMORY_PRIORITY_LOW	Baixa prioridade de memória.
MEMORY_PRIORITY_MEDIUM	Prioridade média de memória.
MEMORY_PRIORITY_BELOW_NORMAL	Abaixo da prioridade de memória normal.
MEMORY_PRIORITY_NORMAL	Prioridade de memória normal. Essa é a prioridade padrão para todos os threads e processos no sistema.

[in] ThreadInformationLength

O tamanho, em bytes, de ThreadInformation.

Valor de retorno

ZwSetInformationThread 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

ZwSetInformationThread 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 ZwSetInformationThread. No entanto, um driver pode chamar ZwSetInformationThread 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 ZwSetInformationThread 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 determinar a prioridade de página de um thread, chame ZwQueryInformationThread.

Se a chamada para essa função ocorrer no modo de usuário, você deverá usar o nome NtSetInformationThread em vez de ZwSetInformationThread.

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

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	ntddk.h (inclua Ntddk.h, Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte também

KeSetBasePriorityThread

KeSetPriorityThread

PsCreateSystemThread

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

Compartilhar via