Función NtSetInformationThread (ntifs.h)

La rutina NtSetInformationThread establece la prioridad de un subproceso.

Sintaxis

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

Parámetros

[in] ThreadHandle

Identificador del objeto de subproceso. Para crear un subproceso y obtener un identificador, llame a PsCreateSystemThread. Para especificar el subproceso actual, use la macro ZwCurrentThread .

[in] ThreadInformationClass

Uno de los valores definidos por el sistema en la enumeración THREADINFOCLASS (vea ntddk.h), ThreadPriority, ThreadBasePriority, ThreadPagePriority o ThreadPowerThrottlingState.

[in] ThreadInformation

Puntero a una variable que especifica la información que se va a establecer.

Si ThreadInformationClass es ThreadPriority, este valor debe ser > LOW_PRIORITY y <= HIGH_PRIORITY.

Si ThreadInformationClass es ThreadBasePriority, este valor debe estar dentro del intervalo de prioridad base válido del sistema y la clase de prioridad original para el subproceso especificado. Es decir, si la clase de prioridad de un subproceso es variable, la prioridad base de ese subproceso no se puede restablecer a un valor de prioridad en tiempo real y viceversa.

Si ThreadInformationClass es ThreadPagePriority, este valor es un puntero a una estructura de PAGE_PRIORITY_INFORMATION , vea ntddk.h. El valor del miembro PagePriority debe ser uno de estos valores.

Si ThreadInformationClass es ThreadPowerThrottlingState, este valor es un puntero a una estructura POWER_THROTTLING_THREAD_STATE , vea ntddk.h. El valor del miembro PagePriority debe ser uno de estos valores.

[in] ThreadInformationLength

Tamaño, en bytes, de ThreadInformation.

Valor devuelto

NtSetInformationThread devuelve STATUS_SUCCESS si se ejecuta correctamente o el código de error NTSTATUS adecuado en caso de error. Entre los códigos de error posibles se incluyen STATUS_INFO_LENGTH_MISMATCH o STATUS_INVALID_PARAMETER.

Comentarios

Los controladores de nivel superior pueden llamar a NtSetInformationThread para establecer la prioridad de un subproceso para el que tienen un identificador.

El autor de la llamada debe tener THREAD_SET_INFORMATION derechos de acceso para el subproceso especificado para llamar a esta rutina.

Normalmente, los controladores intermedios y de dispositivo que configuran subprocesos creados por controladores llaman a KeSetBasePriorityThread o KeSetPriorityThread desde sus subprocesos creados por el controlador, en lugar de llamar a NtSetInformationThread. Sin embargo, un controlador puede llamar a NtSetInformationThread para aumentar la prioridad de un subproceso creado por el controlador antes de que se ejecute ese subproceso.

Los controladores de modo kernel pueden llamar a la función NtSetInformationThread con ThreadPagePriority para especificar la prioridad de página de un subproceso.

Para ayudar a mejorar el rendimiento del sistema, los controladores deben usar la función con ThreadPagePriority para reducir la prioridad de página de los subprocesos que realizan operaciones en segundo plano o acceder a archivos y datos a los que no se espera que se vuelva a acceder pronto. Por ejemplo, una aplicación antimalware podría reducir la prioridad de los subprocesos implicados en el examen de archivos.

En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Windows Native System Services pueden comportarse de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines..

Requisitos

Consulte también

KeSetBasePriorityThread

KeSetPriorityThread

PsCreateSystemThread

Usar las versiones Nt y Zw de las rutinas nativas de Servicios del sistema.