JOBOBJECT_BASIC_LIMIT_INFORMATION-Struktur (winnt.h)

Enthält grundlegende Grenzwertinformationen für ein Auftragsobjekt.

Syntax

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;

Member

PerProcessUserTimeLimit

Wenn LimitFlagsJOB_OBJECT_LIMIT_PROCESS_TIME angibt, ist dieses Element das Pro-Prozess-Ausführungszeitlimit für den Benutzermodus in 100 Nanosekunden-Ticks. Andernfalls wird dieser Member ignoriert.

Das System überprüft in regelmäßigen Abständen, um zu ermitteln, ob jeder dem Auftrag zugeordnete Prozess mehr Benutzermoduszeit als das festgelegte Limit angesammelt hat. Falls ja, wird der Prozess beendet.

Wenn der Auftrag geschachtelt ist, ist der effektive Grenzwert das einschränkendste Limit in der Auftragskette.

PerJobUserTimeLimit

Wenn LimitFlagsJOB_OBJECT_LIMIT_JOB_TIME angibt, ist dieser Member das Ausführungszeitlimit pro Auftrag für den Benutzermodus in 100 Nanosekunden-Ticks. Andernfalls wird dieser Member ignoriert.

Das System fügt diesem Grenzwert die aktuelle Zeit der dem Auftrag zugeordneten Prozesse hinzu. Wenn Sie beispielsweise dieses Limit auf 1 Minute festlegen und der Auftrag über einen Prozess verfügt, der 5 Minuten Benutzermoduszeit angesammelt hat, beträgt das tatsächlich erzwungene Limit 6 Minuten.

Das System überprüft in regelmäßigen Abständen, um zu ermitteln, ob die Summe der Ausführungszeit im Benutzermodus für alle Prozesse größer ist als dieses Grenzwert für das Auftragsende. Wenn dies der Grund ist, wird die aktion ausgeführt, die im EndOfJobTimeAction-Member der JOBOBJECT_END_OF_JOB_TIME_INFORMATION Struktur angegeben ist. Standardmäßig werden alle Prozesse beendet, und der status Code ist auf ERROR_NOT_ENOUGH_QUOTA festgelegt.

Um sich für Benachrichtigungen zu registrieren, wenn dieser Grenzwert überschritten wird, ohne Prozesse zu beenden, verwenden Sie die SetInformationJobObject-Funktion mit der JobObjectNotificationLimitInformation-Informationsklasse .

LimitFlags

Die geltenden Grenzwertflags. Dieses Element ist ein Bitfeld, das bestimmt, ob andere Strukturmember verwendet werden. Es kann eine beliebige Kombination der folgenden Werte angegeben werden.

MinimumWorkingSetSize

Wenn LimitFlagsJOB_OBJECT_LIMIT_WORKINGSET angibt, ist dieser Member die minimale Arbeitssatzgröße in Byte für jeden dem Auftrag zugeordneten Prozess. Andernfalls wird dieser Member ignoriert.

Wenn MaximumWorkingSetSize ungleich null ist, darf MinimumWorkingSetSize nicht 0 sein.

MaximumWorkingSetSize

Wenn LimitFlagsJOB_OBJECT_LIMIT_WORKINGSET angibt, ist dieser Member die maximale Arbeitssatzgröße in Bytes für jeden dem Auftrag zugeordneten Prozess. Andernfalls wird dieser Member ignoriert.

Wenn MinimumWorkingSetSize ungleich null ist, darf MaximumWorkingSetSize nicht 0 sein.

ActiveProcessLimit

Wenn LimitFlagsJOB_OBJECT_LIMIT_ACTIVE_PROCESS angibt, ist dieses Element der aktive Prozessgrenzwert für den Auftrag. Andernfalls wird dieser Member ignoriert.

Wenn Sie versuchen, einen Prozess einem Auftrag zuzuordnen, und dies bewirkt, dass die Anzahl der aktiven Prozesse diesen Grenzwert überschreitet, wird der Prozess beendet, und die Zuordnung schlägt fehl.

Affinity

Wenn LimitFlagsJOB_OBJECT_LIMIT_AFFINITY angibt, ist dieses Element die Prozessoraffinität für alle Dem Auftrag zugeordneten Prozesse. Andernfalls wird dieser Member ignoriert.

Die Affinität muss eine Teilmenge der Systemaffinitätsmaske sein, die durch Aufrufen der GetProcessAffinityMask-Funktion abgerufen wird. Die Affinität jedes Threads ist auf diesen Wert festgelegt, aber Threads können ihre Affinität anschließend festlegen, solange es sich um eine Teilmenge der angegebenen Affinitätsmaske handelt. Prozesse können keine eigene Affinitätsmaske festlegen.

PriorityClass

Wenn LimitFlagsJOB_OBJECT_LIMIT_PRIORITY_CLASS angibt, ist dieser Member die Prioritätsklasse für alle Prozesse, die dem Auftrag zugeordnet sind. Andernfalls wird dieser Member ignoriert.

Prozesse und Threads können ihre Prioritätsklasse nicht ändern. Der aufrufende Prozess muss die berechtigung SE_INC_BASE_PRIORITY_NAME aktivieren.

SchedulingClass

Wenn LimitFlagsJOB_OBJECT_LIMIT_SCHEDULING_CLASS angibt, ist dieser Member die Planungsklasse für alle Prozesse, die dem Auftrag zugeordnet sind. Andernfalls wird dieser Member ignoriert.

Die gültigen Werte sind 0 bis 9. Verwenden Sie 0 für die am wenigsten günstige Planungsklasse im Verhältnis zu anderen Threads und 9 für die günstigste Planungsklasse im Vergleich zu anderen Threads. Standardmäßig ist dieser Wert 5. Um eine Planungsklasse verwenden zu können, die größer als 5 ist, muss der aufrufende Prozess die berechtigung SE_INC_BASE_PRIORITY_NAME aktivieren.

Hinweise

Prozesse können weiterhin ihre Arbeitssätze mithilfe der SetProcessWorkingSetSize-Funktion mit (SIZE_T)-1 leeren, auch wenn JOB_OBJECT_LIMIT_WORKINGSET verwendet wird. Sie können jedoch mit SetProcessWorkingSetSize die minimale oder maximale Arbeitssatzgröße eines Prozesses in einem Auftragsobjekt nicht ändern.

Das System erhöht die Anzahl der aktiven Prozesse, wenn Sie versuchen, einen Prozess einem Auftrag zuzuordnen. Wenn der Grenzwert überschritten wird, verringert das System die Anzahl der aktiven Prozesse nur, wenn der Prozess beendet und alle Handles für den Prozess geschlossen werden. Wenn Sie also über ein offenes Handle für einen Prozess verfügen, der auf diese Weise beendet wurde, können Sie keine neuen Prozesse zuordnen, bis das Handle geschlossen ist und die Anzahl der aktiven Prozesse unter dem Grenzwert liegt.

Anforderungen

Weitere Informationen

GetProcessAffinityMask

JOBOBJECT_END_OF_JOB_TIME_INFORMATION

JOBOBJECT_EXTENDED_LIMIT_INFORMATION

JOBOBJECT_NOTIFICATION_LIMIT_INFORMATION

QueryInformationJobObject

SetInformationJobObject

SetProcessWorkingSetSize