структура JOBOBJECT_IO_RATE_CONTROL_INFORMATION (jobapi2.h)

Статья
01/16/2025

Windows 10 версии 1607 и более поздних версий: эта структура не поддерживается.

Содержит сведения, используемые для управления скоростью ввода-вывода для задания. Эта структура используется функциями SetIoRateControlInformationJobObject и QueryIoRateControlInformationJobObject.

Синтаксис

typedef struct JOBOBJECT_IO_RATE_CONTROL_INFORMATION {
  LONG64 MaxIops;
  LONG64 MaxBandwidth;
  LONG64 ReservationIops;
  PCWSTR VolumeName;
  ULONG  BaseIoSize;
  ULONG  ControlFlags;
} JOBOBJECT_IO_RATE_CONTROL_INFORMATION;

Члены

MaxIops

Максимальное ограничение скорости ввода-вывода в операциях ввода-вывода в секунду (операций ввода-вывода в секунду). Установите значение 0, если не указать ограничения.

При установке MaxIops и MaxBandwithоперационная система применяет первое ограничение, которое достигает скорости ввода-вывода.

MaxBandwidth

Максимальное ограничение скорости ввода-вывода в байтах в секунду. Задайте значение 0, чтобы не задать ограничение.

При установке MaxBandwith и MaxIopsоперационная система применяет первое ограничение, которое достигает скорости ввода-вывода.

ReservationIops

Задает минимальную частоту ввода-вывода, которую операционная система резервирует для задания. Чтобы не резервировать задание, задайте для этого значения значение 0.

Операционная система позволяет заданию выполнять операции ввода-вывода с такой скоростью, если это возможно. Если сумма минимальных ставок для всех заданий превышает емкость операционной системы, скорость, с которой операционная система позволяет каждому заданию выполнять операции ввода-вывода, пропорциональны резервированию для задания.

VolumeName

Имя устройства NT для тома, к которому требуется применить политику для скорости ввода-вывода. Сведения об именах устройств NT см. в имен устройств NT.

Если этот элемент null, политика скорости ввода-вывода применяется ко всем томам операционной системы. Например, если этот элемент равен значение NULL, а MaxIops член равен 100, максимальное ограничение скорости ввода-вывода для каждого тома равно 100 операций ввода-вывода, а не задав агрегированное ограничение скорости ввода-вывода для всех томов 100 операций ввода-вывода в секунду.

BaseIoSize

Базовый размер нормализованной единицы ввода-вывода в байтах. Например, если элемент BaseIoSize составляет 8000, каждые 8 000 байт подсчитывается как единица ввода-вывода. 4000 байтов также является одной единицей ввода-вывода в этом примере, а 8001 байт — две единицы ввода-вывода.

Вы можете задать значение этого базового размера ввода-вывода с помощью значения StorageBaseIOSizeHKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\QoS

раздел реестра.

Значение элемента BaseIoSize зависит от следующих ограничений:

Функция SetIoRateControlInformationJobObject требует, чтобы элемент BaseIoSize структуры JOBOBJECT_IO_RATE_CONTROL_INFORMATION, передаваемой функции, равен 0.
Метод QueryIoRateControlInformationJobObject задает элемент BaseIoSize значение 0, если том, который указывает элемент volumeName , не поддерживает контроль скорости ввода-вывода.
Метод QueryIoRateControlInformationJobObject задает элемент BaseIoSize в этой структуре базовый размер нормализованного единица ввода-вывода, если том, который имя_тома указывает, поддерживает управление скоростью ввода-вывода.

Чтобы запросить базовый размер нормализованного блока ввода-вывода без создания задания, вызовите QueryIoRateControlInformationJobObject с параметром hJob значение NULL из процесса, не связанного с заданием.

ControlFlags

Политика контроля скорости ввода-вывода. Этот элемент может быть одним из следующих значений.

Ценность	Значение
JOB_OBJECT_IO_RATE_CONTROL_ENABLE 0x1	Включает контроль скорости ввода-вывода для задания при передаче этой структуры в функцию SetIoRateControlInformationJobObject. Указывает, что контроль скорости ввода-вывода для задания включен при использовании этой структуры с функцией QueryIoRateControlInformationJobObject.

Ценность

Значение

JOB_OBJECT_IO_RATE_CONTROL_ENABLE
0x1

Включает контроль скорости ввода-вывода для задания при передаче этой структуры в функцию SetIoRateControlInformationJobObject. Указывает, что контроль скорости ввода-вывода для задания включен при использовании этой структуры с функцией QueryIoRateControlInformationJobObject.

Замечания

Для задания в иерархии вложенных заданий можно задать только один элемент управления скоростью ввода-вывода. Заданные параметры применяются к заданию и дочерним заданиям в иерархии для этого задания. Параметры не применяются к цепочке заданий из родительского задания до верхней части иерархии. Вы по-прежнему можете изменить параметры исходного задания в иерархии, в которой установлен контроль скорости ввода-вывода. Однако пытается задать значения для управления скоростью ввода-вывода для любых других заданий в иерархии, включая родительские задания, сбой.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2016 [только классические приложения]
заголовка	jobapi2.h

См. также

QueryIoRateControlInformationJobObject

SetIoRateControlInformationJobObject

Поделиться через