JOBOBJECT_IO_RATE_CONTROL_INFORMATION-Struktur (jobapi2.h)
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.
ControlFlags
Die Richtlinie zur Steuerung der E/A-Rate. Dieser Member 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. |
Hinweise
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 10 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Kopfzeile | jobapi2.h |