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

Подпрограмма 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 , была инициализирована, но одно или несколько его значений-членов являются недопустимыми. Это код ошибки.

Примечания

Эта подпрограмма доступна начиная с Windows Vista.

Подпрограмма 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 (include Fltkernel.h)
Библиотека Fltmgr.lib
IRQL <= DISPATCH_LEVEL

См. также

FLT_CALLBACK_DATA

FltGetIoPriorityHint

FltGetIoPriorityHintFromCallbackData

FltGetIoPriorityHintFromFileObject

FltGetIoPriorityHintFromThread

FltRetrieveIoPriorityInfo

FltSetIoPriorityHintIntoCallbackData

FltSetIoPriorityHintIntoFileObject

FltSetIoPriorityHintIntoThread

IO_PRIORITY_INFO