Функция FltApplyPriorityInfoThread (fltkernel.h)

Статья
08/07/2023

Подпрограмма FltApplyPriorityInfoThread используется драйвером минифильтра для применения сведений о приоритете к потоку.

Синтаксис

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

Параметры

[in] InputPriorityInfo

Указатель на структуру IO_PRIORITY_INFO , которая используется для задания состояния приоритета заданного потока. В этой IO_PRIORITY_INFO структура должна иметь элементы, заданные соответствующей процедурой. См. следующий раздел о примечаниях. Этот параметр является обязательным и не может иметь значение NULL.

[out, optional] OutputPriorityInfo

Необязательный указатель на структуру IO_PRIORITY_INFO, используемую для получения состояния приоритета потока перед применением к потоку сведений о приоритете InputPriorityInfo с помощью FltApplyPriorityInfoThread. Этот параметр является необязательным и может иметь значение NULL.

[in] Thread

Указатель на поток, к которому следует применить сведения о приоритете InputPriorityInfo . Этот параметр является обязательным и не может иметь значение NULL.

Возвращаемое значение

Если сведения о приоритете потока, на которые указывает параметр InputPriorityInfo , успешно применяются к данному потоку, подпрограмма FltApplyPriorityInfoThread возвращает STATUS_SUCCESS. В противном случае возвращается соответствующее значение NTSTATUS, например одно из следующих значений:

Код возврата	Описание
STATUS_INVALID_PARAMETER_1	Структура, на которую указывает параметр InputPriorityInfo , инициализирована, но одно или несколько значений ее членов являются недопустимыми. Это код ошибки.

Подпрограмма FltApplyPriorityInfoThread задает приоритет ввода-вывода, приоритет разбиения по страницам и приоритет потока заданного потока на основе значений элементов структуры IO_PRIORITY_INFO, на которую указывает параметр InputPriorityInfo . Это позволяет применить к потоку ранее сохраненный набор сведений о приоритете, полученных подпрограммой FltRetrieveIoPriorityInfo или FltApplyPriorityInfoThread .

Исходные значения целевого потока до применения значений приоритета InputPriorityInfo подпрограммой FltApplyPriorityInfoThread можно сохранить, если указан допустимый указатель OutputPriorityInfo . Обратите внимание, что структура, на которую указывает параметр OutputPriorityInfo , не требуется инициализировать.

Можно безопасно предоставить один и тот же указатель на одну структуру IO_PRIORITY_INFO для параметров InputPriorityInfo и OutputPriorityInfo .

Примечание Если значения элементов структуры IO_PRIORITY_INFO, на которую указывает параметр InputPriorityInfo , не заданы, необходимо задать эти члены перед вызовом подпрограммы FltApplyPriorityInfoThread с помощью одного из следующих методов:

Вызовите подпрограмму FltRetrieveIoPriorityInfo .
Убедитесь, что текущий параметр InputPriorityInfo был параметром OutputPriorityInfo в предыдущем вызове подпрограммы FltApplyPriorityInfoThread .

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Microsoft Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа	Универсальное
Верхняя часть	fltkernel.h (включая Fltkernel.h)
Библиотека	Fltmgr.lib
IRQL	<= DISPATCH_LEVEL