structure JOBOBJECT_IO_RATE_CONTROL_INFORMATION (jobapi2.h)
Windows 10, version 1607 et ultérieure : cette structure n’est pas prise en charge.
Contient des informations utilisées pour contrôler le taux d’E/S d’un travail. Cette structure est utilisée par les fonctions SetIoRateControlInformationJobObject et QueryIoRateControlInformationJobObject.
Syntaxe
typedef struct JOBOBJECT_IO_RATE_CONTROL_INFORMATION {
LONG64 MaxIops;
LONG64 MaxBandwidth;
LONG64 ReservationIops;
PCWSTR VolumeName;
ULONG BaseIoSize;
ULONG ControlFlags;
} JOBOBJECT_IO_RATE_CONTROL_INFORMATION;
Membres
MaxIops
Limite maximale pour le taux d’E/S dans les opérations d’E/S par seconde (IOPS). Définissez la valeur 0 si vous ne spécifiez aucune limite.
Lorsque vous définissez les deux MaxIops et MaxBandwith, le système d’exploitation applique la première limite atteinte par le taux d’E/S.
MaxBandwidth
Limite maximale pour le taux d’E/S en octets par seconde. Définissez la valeur 0 pour spécifier aucune limite.
Lorsque vous définissez à la fois MaxBandwith et MaxIops, le système d’exploitation applique la première limite atteinte par le taux d’E/S.
ReservationIops
Définit un taux d’E/S minimal que le système d’exploitation réserve pour le travail. Pour ne pas réserver le travail, définissez cette valeur sur 0.
Le système d’exploitation permet au travail d’effectuer des opérations d’E/S à ce rythme, si possible. Si la somme des taux minimaux pour tous les travaux dépasse la capacité du système d’exploitation, le taux auquel le système d’exploitation permet à chaque travail d’effectuer des opérations d’E/S est proportionnel à la réservation du travail.
VolumeName
Nom de l’appareil NT pour le volume auquel vous souhaitez appliquer la stratégie pour le taux d’E/S. Pour plus d’informations sur les noms d’appareils NT, consultez noms d’appareils NT.
Si ce membre est NULL, la stratégie pour le taux d’E/S s’applique à tous les volumes du système d’exploitation. Par exemple, si ce membre est null et que le MaxIops membre est de 100, la limite maximale pour le taux d’E/S pour chaque volume est définie sur 100 IOPS, au lieu de définir une limite d’agrégation pour le taux d’E/S sur tous les volumes de 100 IOPS.
BaseIoSize
Taille de base de l’unité d’E/S normalisée, en octets. Par exemple, si le membre BaseIoSize est de 8 000 octets, tous les 8 000 octets comptent comme une unité d’E/S. 4 000 octets sont également une unité d’E/S dans cet exemple, tandis que 8 001 octets sont deux unités d’E/S.
Vous pouvez définir la valeur de cette taille d’E/S de base à l’aide de la valeur StorageBaseIOSize de la HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\QoS
clé de Registre.La valeur du membre BaseIoSize est soumise aux contraintes suivantes :
- La fonction SetIoRateControlInformationJobObject nécessite que le membre BaseIoSize de la structure JOBOBJECT_IO_RATE_CONTROL_INFORMATION que vous passez à la fonction est 0.
- La méthode QueryIoRateControlInformationJobObject définit le membre BaseIoSize de cette structure sur 0 si le volume spécifié par le membre VolumeName ne prend pas en charge le contrôle du taux d’E/S.
- La méthode
QueryIoRateControlInformationJobObject définit le membreBaseIoSize de cette structure sur la taille de base de l’unité d’E/S normalisée si le volume spécifié par le membre VolumeNameprend en charge le contrôle du taux d’E/S.
ControlFlags
Stratégie de contrôle du taux d’E/S. Ce membre peut être l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Active le contrôle du taux d’E/S pour le travail lorsque cette structure est transmise à la fonction SetIoRateControlInformationJobObject. Indique que le contrôle du taux d’E/S pour le travail est activé lorsque cette structure est utilisée avec la fonction QueryIoRateControlInformationJobObject. |
Remarques
Vous ne pouvez définir qu’un seul contrôle de débit d’E/S pour un travail dans une hiérarchie de travaux imbriqués. Les paramètres que vous spécifiez s’appliquent à ce travail et aux travaux enfants de la hiérarchie pour ce travail. Les paramètres ne s’appliquent pas à la chaîne de travaux du travail parent jusqu’au haut de la hiérarchie. Vous pouvez toujours modifier les paramètres du travail d’origine dans la hiérarchie sur laquelle vous définissez le contrôle de débit d’E/S. Toutefois, tente de définir des valeurs pour le contrôle du taux d’E/S pour tous les autres travaux de la hiérarchie, y compris les travaux parents, échouent.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10 [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2016 [applications de bureau uniquement] |
| d’en-tête | jobapi2.h |