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 分です。

システムは、すべてのプロセスのユーザー モード実行時間の合計がこのジョブの終了制限を超えるかどうかを定期的に確認します。 その場合、JOBOBJECT_END_OF_JOB_TIME_INFORMATION構造体の EndOfJobTimeAction メンバーで指定されたアクションが実行されます。既定では、すべてのプロセスが終了し、状態コードが ERROR_NOT_ENOUGH_QUOTA に設定されます。

プロセスを終了せずにこの制限を超えたときに通知を登録するには、JobObjectNotificationLimitInformation 情報クラスで SetInformationJobObject 関数を使用します。

LimitFlags

有効な制限フラグ。 このメンバーは、他の構造体メンバーを使用するかどうかを決定するビットフィールドです。 次の値の任意の組み合わせを指定できます。

MinimumWorkingSetSize

LimitFlags で JOB_OBJECT_LIMIT_WORKINGSETが指定されている場合、このメンバーは、ジョブに関連付けられている各プロセスの最小ワーキング セット サイズ (バイト単位) です。 それ以外の場合、このメンバーは無視されます。

MaximumWorkingSetSize が 0 以外の場合、MinimumWorkingSetSize を 0 にすることはできません。

MaximumWorkingSetSize

LimitFlags で JOB_OBJECT_LIMIT_WORKINGSETが指定されている場合、このメンバーは、ジョブに関連付けられている各プロセスの最大ワーキング セット サイズ (バイト単位) です。 それ以外の場合、このメンバーは無視されます。

MinimumWorkingSetSize が 0 以外の場合、MaximumWorkingSetSize を 0 にすることはできません。

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 特権を有効にする必要があります。

解説

プロセスは、(SIZE_T)-1 で SetProcessWorkingSetSize 関数を使用して、JOB_OBJECT_LIMIT_WORKINGSETが使用されている場合でも、作業セットを空にすることができます。 ただし、 SetProcessWorkingSetSize を使用して、ジョブ オブジェクト内のプロセスの最小または最大ワーキング セット サイズを変更することはできません。

システムは、プロセスをジョブに関連付けようとすると、アクティブなプロセス数をインクリメントします。 制限を超えた場合、システムは、プロセスが終了し、プロセスに対するすべてのハンドルが閉じられた場合にのみ、アクティブなプロセス数をデクリメントします。 したがって、このような方法で終了したプロセスに対してオープン ハンドルがある場合、ハンドルが閉じられ、アクティブなプロセス数が制限を下回るまで、新しいプロセスを関連付けることはできません。

要件

関連項目

GetProcessAffinityMask

JOBOBJECT_END_OF_JOB_TIME_INFORMATION

JOBOBJECT_EXTENDED_LIMIT_INFORMATION

JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION

QueryInformationJobObject

SetInformationJobObject

SetProcessWorkingSetSize