JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION_2 structure (winnt.h)
Contains extended information about notification limits for a job object. This structure is used by the SetInformationJobObject and QueryInformationJobObject functions with the JobObjectNotificationLimitInformation2 information class.
Syntax
typedef struct JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION_2 {
DWORD64 IoReadBytesLimit;
DWORD64 IoWriteBytesLimit;
LARGE_INTEGER PerJobUserTimeLimit;
union {
DWORD64 JobHighMemoryLimit;
DWORD64 JobMemoryLimit;
} DUMMYUNIONNAME;
union {
JOBOBJECT_RATE_CONTROL_TOLERANCE RateControlTolerance;
JOBOBJECT_RATE_CONTROL_TOLERANCE CpuRateControlTolerance;
} DUMMYUNIONNAME2;
union {
JOBOBJECT_RATE_CONTROL_TOLERANCE_INTERVAL RateControlToleranceInterval;
JOBOBJECT_RATE_CONTROL_TOLERANCE_INTERVAL CpuRateControlToleranceInterval;
} DUMMYUNIONNAME3;
DWORD LimitFlags;
JOBOBJECT_RATE_CONTROL_TOLERANCE IoRateControlTolerance;
DWORD64 JobLowMemoryLimit;
JOBOBJECT_RATE_CONTROL_TOLERANCE_INTERVAL IoRateControlToleranceInterval;
JOBOBJECT_RATE_CONTROL_TOLERANCE NetRateControlTolerance;
JOBOBJECT_RATE_CONTROL_TOLERANCE_INTERVAL NetRateControlToleranceInterval;
} JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION_2;
Members
IoReadBytesLimit
If the LimitFlags member specifies JOB_OBJECT_LIMIT_JOB_READ_BYTES, this member is the notification limit for the total I/O bytes read by all processes in the job. Otherwise, this member is ignored.
IoWriteBytesLimit
If the LimitFlags parameter specifies JOB_OBJECT_LIMIT_JOB_WRITE_BYTES, this member is the notification limit for the total I/O bytes written by all processes in the job. Otherwise, this member is ignored.
PerJobUserTimeLimit
If the LimitFlags parameter specifies JOB_OBJECT_LIMIT_JOB_TIME, this member is the notification limit for per-job user-mode execution time, in 100-nanosecond ticks. Otherwise, this member is ignored.
The system adds the accumulated execution time of processes associated with the job to this limit when the limit is set. For example, if a process associated with the job has already accumulated 5 minutes of user-mode execution time and the limit is set to 1 minute, the limit actually enforced is 6 minutes.
To specify PerJobUserTimeLimit as an enforceable limit and terminate processes in jobs that exceed the limit, see the JOBOBJECT_BASIC_LIMIT_INFORMATION structure.
DUMMYUNIONNAME
DUMMYUNIONNAME.JobHighMemoryLimit
If the LimitFlags parameter specifies JOB_OBJECT_LIMIT_JOB_MEMORY_HIGH, this member is the notification maximum limit for total virtual memory that can be committed by all processes in the job, in bytes. Otherwise, this member is ignored.
DUMMYUNIONNAME.JobMemoryLimit
If the LimitFlags parameter specifies JOB_OBJECT_LIMIT_JOB_MEMORY, this member is the notification maximum limit for total virtual memory that can be committed by all processes in the job, in bytes. Otherwise, this member is ignored.
DUMMYUNIONNAME2
DUMMYUNIONNAME2.RateControlTolerance
If the LimitFlags parameter specifies JOB_OBJECT_LIMIT_RATE_CONTROL, this member specifies the extent to which a job can exceed its CPU rate control limits during the interval specified by the RateControlToleranceInterval member. Otherwise, this member is ignored.
This member can be one of the following values. If no value is specified, ToleranceHigh is used.
DUMMYUNIONNAME2.CpuRateControlTolerance
If the LimitFlags parameter specifies JOB_OBJECT_LIMIT_CPU_RATE_CONTROL, this member specifies the extent to which a job can exceed its CPU rate control limits during the interval specified by the CpuRateControlToleranceInterval member. Otherwise, this member is ignored.
This member can be one of the following values. If no value is specified, ToleranceHigh is used.
DUMMYUNIONNAME3
DUMMYUNIONNAME3.RateControlToleranceInterval
If the LimitFlags parameter specifies JOB_OBJECT_LIMIT_RATE_CONTROL, this member specifies the interval during which a job's CPU usage is monitored to determine whether the job has exceeded its CPU rate control limits. Otherwise, this member is ignored.
This member can be one of the following values. If no value is specified, ToleranceIntervalShort is used.
DUMMYUNIONNAME3.CpuRateControlToleranceInterval
If the LimitFlags parameter specifies JOB_OBJECT_CPU_LIMIT_RATE_CONTROL, this member specifies the interval during which a job's CPU usage is monitored to determine whether the job has exceeded its CPU rate control limits. Otherwise, this member is ignored.
This member can be one of the following values. If no value is specified, ToleranceIntervalShort is used.
LimitFlags
The limit flags that are in effect. This member is a bitfield that determines whether other structure members are used. Any combination of the following values can be specified.
| Value | Meaning |
|---|---|
|
Establishes the notification threshold for the job-wide sum of private committed memory for all processes associated with the job. The JobHighMemoryLimit member contains additional information. |
|
Establishes the notification minimum for the job-wide sum of private committed memory for all processes associated with the job. If this value is set, a notification is sent when the amount of private committed memory falls below this threshold. The JobLowMemoryLimit member contains additional information. |
|
Establishes the I/O read bytes limit to the job-wide sum of I/O bytes read by all processes associated with the job. The IoReadBytesLimit member contains more information. |
|
Establishes the I/O write bytes limit to the job-wide sum of I/O bytes written by all processes associated with the job. The IoWriteBytesLimit member contains more information. |
|
Establishes the limit for user-mode execution time for the job. The PerJobUserTimeLimit member contains additional information. |
|
Establishes the notification threshold for the CPU rate control limits established for the job. The CpuRateControlTolerance and CpuRateControlToleranceInterval members contain additional information.
CPU rate control limits are established by calling SetInformationJobObject with the JobObjectCpuRateInformationClass information class. |
|
Establishes the notification threshold for the CPU rate control limits established for the job. The RateControlTolerance and RateControlToleranceInterval members contain additional information.
CPU rate control limits are established by calling SetInformationJobObject with the JobObjectCpuRateInformationClass information class. |
|
Establishes the notification threshold for the I/O rate control limits established for the job. The IoRateControlTolerance and IoRateControlToleranceInterval members contain additional information.
I/O rate control limits are established by calling SetIoRateControlInformationJobObject. |
|
Establishes the notification threshold for the network rate control limits established for the job. The NetRateControlTolerance and NetRateControlToleranceInterval members contain additional information.
Network rate control limits are established by calling SetInformationJobObject with the JobObjectNetRateInformationClass information class. |
IoRateControlTolerance
If the LimitFlags parameter specifies JOB_OBJECT_LIMIT_IO_RATE_CONTROL, this member specifies the extent to which a job can exceed its I/O rate control limits during the interval specified by the IoRateControlToleranceInterval member. Otherwise, this member is ignored.
This member can be one of the following values. If no value is specified, ToleranceHigh is used.
JobLowMemoryLimit
If the LimitFlags parameter specifies JOB_OBJECT_LIMIT_JOB_MEMORY_LOW, this member is the notification limit minimum for the total virtual memory that can be committed by all processes in the job, in bytes. Otherwise, this member is ignored.
IoRateControlToleranceInterval
If the LimitFlags parameter specifies JOB_OBJECT_IO_LIMIT_RATE_CONTROL, this member specifies the interval during which a job's I/O usage is monitored to determine whether the job has exceeded its I/O rate control limits. Otherwise, this member is ignored.
This member can be one of the following values. If no value is specified, ToleranceIntervalShort is used.
NetRateControlTolerance
If the LimitFlags parameter specifies JOB_OBJECT_LIMIT_IO_RATE_CONTROL, this member specifies the extent to which a job can exceed its network rate control limits during the interval specified by the NetRateControlToleranceInterval member. Otherwise, this member is ignored.
This member can be one of the following values. If no value is specified, ToleranceHigh is used.
NetRateControlToleranceInterval
If the LimitFlags parameter specifies JOB_OBJECT_NET_LIMIT_RATE_CONTROL, this member specifies the interval during which a job's network usage is monitored to determine whether the job has exceeded its network rate control limits. Otherwise, this member is ignored.
This member can be one of the following values. If no value is specified, ToleranceIntervalShort is used.
Remarks
When a notification limit is exceeded, the system sends a JOB_OBJECT_MSG_NOTIFICATION_LIMIT message to the I/O completion port associated with the job. Processes in the job continue to run and can continue to allocate memory or transmit read or write bytes beyond the specified limits.
When the application monitoring the I/O completion port receives a JOB_OBJECT_MSG_NOTIFICATION_LIMIT message, it must call QueryInformationJobObject with the JobObjectLimitViolationInformation2 information class. Limit violation information is received in a JOBOBJECT_LIMIT_VIOLATION_INFORMATION_2 structure that contains information about all notification limits that were exceeded at the time of the query. The system will not send another JOB_OBJECT_MSG_NOTIFICATION_LIMIT message until after QueryInformationJobObject is called.
CPU rate control limits for a job are established in a JOBOBJECT_CPU_RATE_CONTROL_INFORMATION structure. The CPU rate control values in the JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION_2 structure specify how much the job can exceed its established CPU rate control limits before notification is sent.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10 [desktop apps only] |
| Minimum supported server | Windows Server 2016 [desktop apps only] |
| Header | winnt.h |
See also
JOBOBJECT_CPU_RATE_CONTROL_INFORMATION
JOBOBJECT_IO_RATE_CONTROL_INFORMATION
JOBOBJECT_LIMIT_VIOLATION_INFORMATION_2