JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION_2 structure

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.

Value Meaning
ToleranceLow
1
The job can exceed its CPU rate control limits for 20% of the tolerance interval.
ToleranceMedium
2
The job can exceed its CPU rate control limits for 40% of the tolerance interval.
ToleranceHigh
3
The job can exceed its CPU rate control limits for 60% of the tolerance interval.

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.

Value Meaning
ToleranceLow
1
The job can exceed its CPU rate control limits for 20% of the tolerance interval.
ToleranceMedium
2
The job can exceed its CPU rate control limits for 40% of the tolerance interval.
ToleranceHigh
3
The job can exceed its CPU rate control limits for 60% of the tolerance interval.

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.

Value Meaning
ToleranceIntervalShort
1
The tolerance interval is 10 seconds.
ToleranceIntervalMedium
2
The tolerance interval is one minute.
ToleranceIntervalLong
3
The tolerance interval is 10 minutes.

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.

Value Meaning
ToleranceIntervalShort
1
The tolerance interval is 10 seconds.
ToleranceIntervalMedium
2
The tolerance interval is one minute.
ToleranceIntervalLong
3
The tolerance interval is 10 minutes.

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
JOB_OBJECT_LIMIT_JOB_MEMORY_HIGH
0x00000200
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.
JOB_OBJECT_LIMIT_JOB_MEMORY_LOW
0x00008000
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.
JOB_OBJECT_LIMIT_JOB_READ_BYTES
0x00010000
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.
JOB_OBJECT_LIMIT_JOB_WRITE_BYTES
0x00020000
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.
JOB_OBJECT_LIMIT_JOB_TIME
0x00000004
Establishes the limit for user-mode execution time for the job. The PerJobUserTimeLimit member contains additional information.
JOB_OBJECT_LIMIT_CPU_RATE_CONTROL
0x00040000
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.

JOB_OBJECT_LIMIT_RATE_CONTROL
0x00040000
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.

JOB_OBJECT_LIMIT_IO_RATE_CONTROL
0x00080000
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.

JOB_OBJECT_LIMIT_NET_RATE_CONTROL
0x00100000
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.

Value Meaning
ToleranceLow
1
The job can exceed its I/O rate control limits for 20% of the tolerance interval.
ToleranceMedium
2
The job can exceed its I/O rate control limits for 40% of the tolerance interval.
ToleranceHigh
3
The job can exceed its I/O rate control limits for 60% of the tolerance interval.

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.

Value Meaning
ToleranceIntervalShort
1
The tolerance interval is 10 seconds.
ToleranceIntervalMedium
2
The tolerance interval is one minute.
ToleranceIntervalLong
3
The tolerance interval is 10 minutes.

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.

Value Meaning
ToleranceLow
1
The job can exceed its network rate control limits for 20% of the tolerance interval.
ToleranceMedium
2
The job can exceed its network rate control limits for 40% of the tolerance interval.
ToleranceHigh
3
The job can exceed its network rate control limits for 60% of the tolerance interval.

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.

Value Meaning
ToleranceIntervalShort
1
The tolerance interval is 10 seconds.
ToleranceIntervalMedium
2
The tolerance interval is one minute.
ToleranceIntervalLong
3
The tolerance interval is 10 minutes.

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

   
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

JOBOBJECT_NET_RATE_CONTROL_INFORMATION

QueryInformationJobObject

SetInformationJobObject

SetIoRateControlInformationJobObject