JOBOBJECT_IO_RATE_CONTROL_INFORMATION-Struktur (jobapi2.h)

Artikel
08/24/2023

Enthält Informationen, die zum Steuern der E/A-Rate für einen Auftrag verwendet werden. Diese Struktur wird von den Funktionen SetIoRateControlInformationJobObject und QueryIoRateControlInformationJobObject verwendet.

Syntax

typedef struct JOBOBJECT_IO_RATE_CONTROL_INFORMATION {
  LONG64 MaxIops;
  LONG64 MaxBandwidth;
  LONG64 ReservationIops;
  PCWSTR VolumeName;
  ULONG  BaseIoSize;
  ULONG  ControlFlags;
} JOBOBJECT_IO_RATE_CONTROL_INFORMATION;

Members

MaxIops

Der maximale Grenzwert für die E/A-Rate in E/A-Vorgängen pro Sekunde (IOPS). Legen Sie auf 0 fest, wenn kein Limit angegeben werden soll.

Wenn Sie sowohl MaxIops als auch MaxBandwith festlegen, erzwingt das Betriebssystem das erste Limit, das die E/A-Rate erreicht.

MaxBandwidth

Der maximale Grenzwert für die E/A-Rate in Bytes pro Sekunde. Legen Sie auf 0 fest, um kein Limit anzugeben.

Wenn Sie sowohl MaxBandwith als auch MaxIops festlegen, erzwingt das Betriebssystem das erste Limit, das die E/A-Rate erreicht.

ReservationIops

Legt eine minimale E/A-Rate fest, die das Betriebssystem für den Auftrag reserviert. Um keine Reservierung für den Auftrag vorzunehmen, legen Sie diesen Wert auf 0 fest.

Das Betriebssystem ermöglicht dem Auftrag, E/A-Vorgänge mit dieser Geschwindigkeit auszuführen, wenn möglich. Wenn die Summe der Mindestsätze für alle Aufträge die Kapazität des Betriebssystems überschreitet, ist die Rate, mit der das Betriebssystem jedem Auftrag die Ausführung von E/A-Vorgängen zulässt, proportional zur Reservierung für den Auftrag.

VolumeName

Der NT-Gerätename für das Volume, auf das Sie die Richtlinie für die E/A-Rate anwenden möchten. Informationen zu NT-Gerätenamen finden Sie unter NT-Gerätenamen.

Wenn dieser Member NULL ist, gilt die Richtlinie für die E/A-Rate für alle Volumes für das Betriebssystem. Wenn dieser Member beispielsweise NULL ist und der MaxIops-Member 100 ist, wird der maximale Grenzwert für die E/A-Rate für jedes Volume auf 100 IOPS festgelegt, anstatt ein Aggregatlimit für die E/A-Rate für alle Volumes von 100 IOPS festzulegen.

BaseIoSize

Die Basisgröße der normalisierten E/A-Einheit in Bytes. Wenn der BaseIoSize-Member beispielsweise 8.000 ist, zählen alle 8.000 Bytes als eine E/A-Einheit. 4.000 Bytes sind auch eine E/A-Einheit in diesem Beispiel, während 8.001 Bytes zwei E/A-Einheiten sind.

Sie können den Wert dieser Basis-E/A-Größe festlegen, indem Sie den StorageBaseIOSize-Wert der HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet-Steuerelement\\QoS verwenden.

Registrierungsschlüssel.

Der Wert des BaseIoSize-Elements unterliegt den folgenden Einschränkungen:

Die SetIoRateControlInformationJobObject-Funktion erfordert, dass das BaseIoSize-Element der JOBOBJECT_IO_RATE_CONTROL_INFORMATION Struktur, das Sie an die Funktion übergeben, 0 ist.
Die QueryIoRateControlInformationJobObject-Methode legt das BaseIoSize-Element dieser Struktur auf 0 fest, wenn das volumeName-Element, das vom VolumeName-Member angegeben ist, die Steuerung der E/A-Rate nicht unterstützt.
Die QueryIoRateControlInformationJobObject-Methode legt das BaseIoSize-Element dieser Struktur auf die Basisgröße der normalisierten E/A-Einheit fest, wenn das Volume, das vom VolumeName-Member angegeben wird, die Steuerung der E/A-Rate unterstützt.

Um die Basisgröße der normalisierten E/A-Einheit abzufragen, ohne einen Auftrag zu erstellen, rufen Sie QueryIoRateControlInformationJobObject auf, wobei der hJob-Parameter von einem Prozess, der nicht einem Auftrag zugeordnet ist, auf NULL festgelegt ist.

ControlFlags

Die Richtlinie zur Steuerung der E/A-Rate. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
JOB_OBJECT_IO_RATE_CONTROL_ENABLE 0x1	Aktiviert die Steuerung der E/A-Rate für den Auftrag, wenn diese Struktur an die SetIoRateControlInformationJobObject-Funktion übergeben wird. Gibt an, dass die Steuerung der E/A-Rate für den Auftrag aktiviert ist, wenn diese Struktur mit der QueryIoRateControlInformationJobObject-Funktion verwendet wird.

Hinweise

Wichtig Ab Windows 10 Version 1607 wird diese Struktur nicht mehr unterstützt.

Sie können nur ein E/A-Ratensteuerelement für einen Auftrag in einer Hierarchie geschachtelter Aufträge festlegen. Die von Ihnen angegebenen Einstellungen gelten für diesen Auftrag und die untergeordneten Aufträge in der Hierarchie für diesen Auftrag. Die Einstellungen gelten nicht für die Auftragskette vom übergeordneten Auftrag bis zum oberen Rand der Hierarchie. Sie können weiterhin die Einstellungen für den ursprünglichen Auftrag in der Hierarchie ändern, für die Sie die E/A-Ratensteuerung festlegen. Versuche, Werte für die Steuerung der E/A-Rate für alle anderen Aufträge in der Hierarchie festzulegen, einschließlich der übergeordneten Aufträge, schlagen jedoch fehl.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 10 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Kopfzeile	jobapi2.h

Weitere Informationen

QueryIoRateControlInformationJobObject

SetIoRateControlInformationJobObject

Freigeben über