struttura JOBOBJECT_IO_RATE_CONTROL_INFORMATION (jobapi2.h)

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;

Members

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 impostano 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 frequenza 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.For information about NT device names, see NT Device Names.

Se questo membro è NULL, il criterio per la velocità di I/O si applica 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_MACHINE\\ SYSTEMCurrentControlSet\Control\QoS

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 passato 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 frequenza di I/O.
• Il metodo QueryIoRateControlInformationJobObject imposta il membro BaseIoSize di questa struttura sulle dimensioni di base dell'unità di 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à di 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

Criteri per il controllo della frequenza di I/O. Questo membro può essere uno dei valori seguenti.

Valore	Significato
JOB_OBJECT_IO_RATE_CONTROL_ENABLE 0x1	Attiva il controllo della velocità 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 è attivato quando questa struttura viene usata con la funzione QueryIoRateControlInformationJobObject .

Commenti

È possibile impostare un solo controllo velocità 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 velocità di I/O. Tuttavia, tenta di impostare i valori per il controllo della velocità di I/O per qualsiasi altro processo nella gerarchia, inclusi i processi padre, ha esito negativo.

Requisiti

Client minimo supportato	Windows 10 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Intestazione	jobapi2.h

Vedi anche

QueryIoRateControlInformationJobObject

SetIoRateControlInformationJobObject