struttura JOBOBJECT_IO_RATE_CONTROL_INFORMATION (jobapi2.h)

Articolo
01/16/2025

Windows 10 versione 1607 e successive: questa struttura non è supportata.

Contiene informazioni utilizzate per controllare la frequenza di I/O per un processo. Questa struttura viene usata dalle funzioni SetIoRateControlInformationJobObject e QueryIoRateControlInformationJobObject.

Sintassi

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

Membri

MaxIops

Limite massimo per la velocità di I/O nelle operazioni di I/O al secondo (IOPS). Impostare su 0 se non specificare alcun limite.

Quando si imposta sia maxIops che MaxBandwith, il sistema operativo applica il primo limite raggiunto dalla velocità di I/O.

MaxBandwidth

Limite massimo per la velocità di I/O in byte al secondo. Impostare su 0 per non specificare alcun limite.

Quando si impostano sia MaxBandwith che MaxIops, il sistema operativo applica il primo limite raggiunto dalla velocità di I/O.

ReservationIops

Imposta una tariffa di I/O minima che il sistema operativo riserva per il processo. Per non effettuare alcuna prenotazione per il processo, impostare questo valore su 0.

Il sistema operativo consente al processo di eseguire operazioni di I/O a questa velocità, se possibile. Se la somma delle tariffe minime per tutti i processi supera la capacità del sistema operativo, la frequenza con cui il sistema operativo consente a ogni processo di eseguire operazioni di I/O è proporzionale alla prenotazione per il processo.

VolumeName

Nome del dispositivo NT per il volume a cui si desidera applicare i criteri per la frequenza di I/O. Per informazioni sui nomi dei dispositivi NT, vedere NT Device Names.

Se questo membro è NULL, i criteri per la frequenza di I/O si applicano a tutti i volumi per il sistema operativo. Ad esempio, se questo membro è NULL e il membro maxIops è 100, il limite massimo per la velocità di I/O per ogni volume è impostato su 100 operazioni di I/O al secondo, anziché impostare un limite di aggregazione per la velocità di I/O in tutti i volumi di 100 operazioni di I/O al secondo.

BaseIoSize

Dimensioni di base dell'unità di I/O normalizzata, in byte. Ad esempio, se il membro baseIoSize è 8.000, ogni 8.000 byte viene conteggiato come un'unità di I/O. 4.000 byte è anche un'unità di I/O in questo esempio, mentre 8.001 byte è di due unità di I/O.

È possibile impostare il valore di questa dimensione di I/O di base usando il valore storageBaseIOSize di HKEY_LOCAL_MACHINESYSTEMCurrentControlSetControlQoS

chiave del Registro di sistema.

Il valore del membro BaseIoSize è soggetto ai vincoli seguenti:

La funzione SetIoRateControlInformationJobObject richiede che il membro BaseIoSize della struttura JOBOBJECT_IO_RATE_CONTROL_INFORMATION passata alla funzione sia 0.
Il metodo QueryIoRateControlInformationJobObject imposta il membro BaseIoSize di questa struttura su 0 se il volume specificato dal membro VolumeName non supporta il controllo della velocità di I/O.
Il metodo QueryIoRateControlInformationJobObject imposta il membro BaseIoSize della struttura sulla dimensione di base dell'unità I/O normalizzata se il volume specificato dal membro VolumeName supporta il controllo della velocità di I/O.

Per eseguire una query sulle dimensioni di base dell'unità I/O normalizzata senza creare un processo, chiamare QueryIoRateControlInformationJobObject con il parametro hJob impostato su NULL da un processo non associato a un processo.

ControlFlags

Criterio per il controllo della velocità di I/O. Questo membro può essere uno dei valori seguenti.

Valore	Significato
JOB_OBJECT_IO_RATE_CONTROL_ENABLE 0x1	Attiva il controllo della frequenza di I/O per il processo quando questa struttura viene passata alla funzione SetIoRateControlInformationJobObject. Indica che il controllo della velocità di I/O per il processo viene attivato quando questa struttura viene usata con la funzione QueryIoRateControlControlInformationJobObject.

Osservazioni

È possibile impostare un solo controllo della frequenza di I/O per un processo in una gerarchia di processi annidati. Le impostazioni specificate si applicano a tale processo e ai processi figlio nella gerarchia per tale processo. Le impostazioni non si applicano alla catena di processi dal processo padre fino alla parte superiore della gerarchia. È comunque possibile modificare le impostazioni per il processo originale nella gerarchia in cui si imposta il controllo della frequenza di I/O. Tuttavia, tenta di impostare i valori per il controllo della frequenza di I/O per qualsiasi altro processo nella gerarchia, inclusi i processi padre, ha esito negativo.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10 [solo app desktop]
server minimo supportato	Windows Server 2016 [solo app desktop]
intestazione	jobapi2.h

Vedere anche

QueryIoRateControlInformationJobObject

SetIoRateControlInformationJobObject

Condividi tramite