структура JOBOBJECT_BASIC_LIMIT_INFORMATION (winnt.h)

Содержит основные сведения об ограничении для объекта задания.

Синтаксис

typedef struct _JOBOBJECT_BASIC_LIMIT_INFORMATION {
  LARGE_INTEGER PerProcessUserTimeLimit;
  LARGE_INTEGER PerJobUserTimeLimit;
  DWORD         LimitFlags;
  SIZE_T        MinimumWorkingSetSize;
  SIZE_T        MaximumWorkingSetSize;
  DWORD         ActiveProcessLimit;
  ULONG_PTR     Affinity;
  DWORD         PriorityClass;
  DWORD         SchedulingClass;
} JOBOBJECT_BASIC_LIMIT_INFORMATION, *PJOBOBJECT_BASIC_LIMIT_INFORMATION;

Члены

PerProcessUserTimeLimit

Если LimitFlags указывает JOB_OBJECT_LIMIT_PROCESS_TIME, этот элемент является ограничением времени выполнения в пользовательском режиме для каждого процесса в 100 наносекундных тактов. В противном случае этот элемент игнорируется.

Система периодически проверяет, накопило ли каждый процесс, связанный с заданием, больше времени в пользовательском режиме, чем заданное ограничение. Если это так, процесс завершается.

Если задание вложено, действующее ограничение является самым строгим ограничением в цепочке заданий.

PerJobUserTimeLimit

Если LimitFlags указывает JOB_OBJECT_LIMIT_JOB_TIME, этот член является ограничением времени выполнения в пользовательском режиме для каждого задания в 100 наносекундных тактов. В противном случае этот элемент игнорируется.

Система добавляет текущее время процессов, связанных с заданием, к этому пределу. Например, если установить это ограничение в 1 минуту и задание содержит процесс, который накопил 5 минут времени в пользовательском режиме, ограничение фактически будет равно 6 минутам.

Система периодически проверяет, превышает ли сумма времени выполнения в пользовательском режиме для всех процессов этот предел завершения задания. Если это так, выполняется действие, указанное в элементе EndOfJobTimeActionструктуры JOBOBJECT_END_OF_JOB_TIME_INFORMATION . По умолчанию все процессы завершаются, а код состояния имеет значение ERROR_NOT_ENOUGH_QUOTA.

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

LimitFlags

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

MinimumWorkingSetSize

Если LimitFlags указывает JOB_OBJECT_LIMIT_WORKINGSET, этот член представляет собой минимальный размер рабочего набора в байтах для каждого процесса, связанного с заданием. В противном случае этот элемент игнорируется.

Если параметр MaximumWorkingSetSize не имеет нуля, параметр MinimumWorkingSetSize не может быть равен нулю.

MaximumWorkingSetSize

Если LimitFlags указывает JOB_OBJECT_LIMIT_WORKINGSET, этот член является максимальным размером рабочего набора в байтах для каждого процесса, связанного с заданием. В противном случае этот элемент игнорируется.

Если параметр MinimumWorkingSetSize не имеет нуля, параметр MaximumWorkingSetSize не может быть равен нулю.

ActiveProcessLimit

Если LimitFlags указывает JOB_OBJECT_LIMIT_ACTIVE_PROCESS, этот член является активным ограничением процесса для задания. В противном случае этот элемент игнорируется.

Если вы пытаетесь связать процесс с заданием и в результате этого число активных процессов превысит это ограничение, процесс завершается и связь завершается сбоем.

Affinity

Если LimitFlags указывает JOB_OBJECT_LIMIT_AFFINITY, этот член является сходством процессоров для всех процессов, связанных с заданием. В противном случае этот элемент игнорируется.

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

PriorityClass

Если LimitFlags указывает JOB_OBJECT_LIMIT_PRIORITY_CLASS, этот член является классом приоритета для всех процессов, связанных с заданием. В противном случае этот элемент игнорируется.

Процессы и потоки не могут изменять класс приоритета. Вызывающий процесс должен включать привилегию SE_INC_BASE_PRIORITY_NAME .

SchedulingClass

Если LimitFlags указывает JOB_OBJECT_LIMIT_SCHEDULING_CLASS, этот член является классом планирования для всех процессов, связанных с заданием. В противном случае этот элемент игнорируется.

Допустимые значения: от 0 до 9. Используйте 0 для наименее благоприятного класса планирования по сравнению с другими потоками и 9 для наиболее благоприятного класса планирования по сравнению с другими потоками. По умолчанию это значение равно 5. Чтобы использовать класс планирования больше 5, вызывающий процесс должен включить привилегию SE_INC_BASE_PRIORITY_NAME .

Комментарии

Процессы по-прежнему могут очищать свои рабочие наборы с помощью функции SetProcessWorkingSetSize с (SIZE_T)-1, даже если используется JOB_OBJECT_LIMIT_WORKINGSET . Однако метод SetProcessWorkingSetSize не может изменять минимальный или максимальный размер рабочего набора процесса в объекте задания.

Система увеличивает число активных процессов при попытке связать процесс с заданием. Если ограничение превышено, система уменьшает число активных процессов только после завершения процесса и закрытия всех дескрипторов процесса. Таким образом, если у вас есть открытый дескриптор для процесса, который был завершен таким образом, вы не сможете связать новые процессы, пока дескриптор не будет закрыт, а число активных процессов не будет ниже ограничения.

Требования

См. также раздел

GetProcessAffinityMask

JOBOBJECT_END_OF_JOB_TIME_INFORMATION

JOBOBJECT_EXTENDED_LIMIT_INFORMATION

JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION

QueryInformationJobObject

SetInformationJobObject

SetProcessWorkingSetSize