Función FltApplyPriorityInfoThread (fltkernel.h)

Artículo
08/07/2023

El controlador de minifiltro usa la rutina FltApplyPriorityInfoThread para aplicar información de prioridad a un subproceso.

Sintaxis

NTSTATUS FLTAPI FltApplyPriorityInfoThread(
  [in]            PIO_PRIORITY_INFO InputPriorityInfo,
  [out, optional] PIO_PRIORITY_INFO OutputPriorityInfo,
  [in]            PETHREAD          Thread
);

Parámetros

[in] InputPriorityInfo

Puntero a una estructura de IO_PRIORITY_INFO que se usa para establecer el estado de prioridad del subproceso especificado. Esta estructura IO_PRIORITY_INFO debe tener sus miembros establecidos por una rutina adecuada; consulte la siguiente sección Comentarios. Este parámetro es obligatorio y no puede ser NULL.

[out, optional] OutputPriorityInfo

Puntero opcional a una estructura de IO_PRIORITY_INFO utilizada para recibir el estado de prioridad del subproceso antes de que la información de prioridad InputPriorityInfo se aplique al subproceso mediante FltApplyPriorityInfoThread. Este parámetro es opcional y puede ser NULL.

[in] Thread

Puntero al subproceso en el que se va a aplicar la información de prioridad InputPriorityInfo . Este parámetro es obligatorio y no puede ser NULL.

Valor devuelto

Si la información de prioridad del subproceso, al que apunta el parámetro InputPriorityInfo , se aplica correctamente al subproceso especificado, la rutina FltApplyPriorityInfoThread devuelve STATUS_SUCCESS. De lo contrario, devuelve un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_INVALID_PARAMETER_1	La estructura a la que apunta el parámetro InputPriorityInfo se inicializó, pero uno o varios de sus valores de miembro no son válidos. Se trata de un código de error.

Comentarios

Esta rutina está disponible a partir de Windows Vista.

La rutina FltApplyPriorityInfoThread establece la prioridad de E/S, la prioridad de paginación y la prioridad de subproceso del subproceso especificado en función de los valores de miembro de la estructura de IO_PRIORITY_INFO a la que apunta el parámetro InputPriorityInfo . Esto permite que un conjunto previamente guardado de información de prioridad, adquirido por la rutina FltRetrieveIoPriorityInfo o FltApplyPriorityInfoThread , se aplique a un subproceso.

Los valores originales del subproceso de destino, antes de que la rutina FltApplyPriorityInfoThread aplique los valores de prioridad InputPriorityInfo, se pueden guardar si se proporciona un puntero OutputPriorityInfo válido. Tenga en cuenta que no es necesario inicializar la estructura a la que apunta el parámetro OutputPriorityInfo .

Es seguro proporcionar el mismo puntero a una única estructura de IO_PRIORITY_INFO para los parámetros InputPriorityInfo y OutputPriorityInfo .

Nota Si no se han establecido los valores de miembro de la estructura de IO_PRIORITY_INFO a la que apunta el parámetro InputPriorityInfo , debe establecer estos miembros, antes de llamar a la rutina FltApplyPriorityInfoThread , mediante uno de los métodos siguientes:

Llame a la rutina FltRetrieveIoPriorityInfo .
Asegúrese de que el parámetro InputPriorityInfo actual era el parámetro OutputPriorityInfo en una llamada anterior a la rutina FltApplyPriorityInfoThread .

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Universal
Encabezado	fltkernel.h (incluya Fltkernel.h)
Library	Fltmgr.lib
IRQL	<= DISPATCH_LEVEL