JOBOBJECT_IO_RATE_CONTROL_INFORMATION Struktur (jobapi2.h)
Windows 10, Version 1607 und höher: Diese Struktur wird nicht unterstützt.
Enthält Informationen zum Steuern der E/A-Rate für einen Auftrag. 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;
Angehörige
MaxIops
Die maximale Grenze für die E/A-Rate in E/A-Vorgängen pro Sekunde (IOPS). Legen Sie auf 0 fest, wenn kein Grenzwert angegeben werden soll.
Wenn Sie sowohl MaxIops als auch MaxBandwithfestlegen, erzwingt das Betriebssystem den ersten Grenzwert, den 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 keinen Grenzwert anzugeben.
Wenn Sie sowohl MaxBandwith als auch MaxIops-festlegen, erzwingt das Betriebssystem den ersten Grenzwert, den die E/A-Rate erreicht.
ReservationIops
Legt einen Mindest-E/A-Satz fest, den 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 es dem Auftrag, E/A-Vorgänge mit dieser Rate durchzuführen, falls 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 Durchführung von E/A-Vorgängen zulässt, proportional zur Reservierung des Auftrags.
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 Device Names.
Wenn dieser Member NULL-ist, gilt die Richtlinie für die E/A-Rate für alle Volumes für das Betriebssystem. Wenn dieses Element z. B. NULL- ist und der MaxIops Member 100 ist, wird der höchstwert für die E/A-Rate für jedes Volume auf 100 IOPS festgelegt, anstatt einen Aggregatgrenzwert 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 beispielsweise das BaseIoSize Member 8.000 ist, zählt jede 8.000 Byte 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 mithilfe des StorageBaseIOSize Werts des HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\QoS- festlegen.
Registrierungsschlüssel.Der Wert des BaseIoSize Members unterliegt den folgenden Einschränkungen:
- Die SetIoRateControlInformationJobObject--Funktion erfordert, dass das BaseIoSize Element der JOBOBJECT_IO_RATE_CONTROL_INFORMATION Struktur, die Sie an die Funktion übergeben, 0 ist.
- Die QueryIoRateControlInformationJobObject- -Methode legt den BaseIoSize- Member dieser Struktur auf 0 fest, wenn das Volume, das VolumeName Member angibt, das Steuerelement 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, das Steuerelement der E/A-Rate unterstützt.
ControlFlags
Die Richtlinie zur Kontrolle der E/A-Rate. Dieses Element kann einer der folgenden Werte sein:
| Wert | Bedeutung |
|---|---|
|
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. |
Bemerkungen
Sie können nur ein E/A-Steuerelement 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 Kette von Aufträgen vom übergeordneten Auftrag bis zum Anfang der Hierarchie. Sie können weiterhin die Einstellungen für den ursprünglichen Auftrag in der Hierarchie ändern, auf der Sie die E/A-Geschwindigkeitssteuerung festlegen. Versuche jedoch, 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 fehl.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10 [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2016 [nur Desktop-Apps] |
| Header- | jobapi2.h |