estructura de JOBOBJECT_IO_RATE_CONTROL_INFORMATION (jobapi2.h)

  • Artículo

Contiene información usada para controlar la tasa de E/S de un trabajo. Esta estructura la usan las funciones SetIoRateControlInformationJobObject y QueryIoRateControlInformationJobObject .

Sintaxis

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

Límite máximo para la velocidad de E/S en operaciones de E/S por segundo (IOPS). Establezca en 0 si se especifica ningún límite.

Al establecer MaxIops y MaxBandwith, el sistema operativo aplica el primer límite que alcanza la velocidad de E/S.

MaxBandwidth

Límite máximo para la velocidad de E/S en bytes por segundo. Establezca en 0 para especificar ningún límite.

Al establecer MaxBandwith y MaxIops, el sistema operativo aplica el primer límite que alcanza la velocidad de E/S.

ReservationIops

Establece una tasa de E/S mínima que el sistema operativo reserva para el trabajo. Para no realizar ninguna reserva para el trabajo, establezca este valor en 0.

El sistema operativo permite al trabajo realizar operaciones de E/S a este ritmo, si es posible. Si la suma de las tarifas mínimas de todos los trabajos supera la capacidad del sistema operativo, la velocidad a la que el sistema operativo permite que cada trabajo realice operaciones de E/S es proporcional a la reserva del trabajo.

VolumeName

Nombre del dispositivo NT para el volumen al que desea aplicar la directiva para la tasa de E/S. Para obtener información sobre los nombres de dispositivos NT, consulte Nombres de dispositivo NT.

Si este miembro es NULL, la directiva de la tasa de E/S se aplica a todos los volúmenes del sistema operativo. Por ejemplo, si este miembro es NULL y el miembro MaxIops es 100, el límite máximo de la velocidad de E/S para cada volumen se establece en 100 IOPS, en lugar de establecer un límite agregado para la velocidad de E/S en todos los volúmenes de 100 IOPS.

BaseIoSize

Tamaño base de la unidad de E/S normalizada, en bytes. Por ejemplo, si el miembro BaseIoSize es de 8000, cada 8000 bytes cuenta como una unidad de E/S. 4000 bytes también es una unidad de E/S en este ejemplo, mientras que 8001 bytes es dos unidades de E/S.

Puede establecer el valor de este tamaño de E/S base mediante el valor StorageBaseIOSize delQoSize del control QoS de HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\ QoS.

Clave del Registro.

El valor del miembro BaseIoSize está sujeto a las restricciones siguientes:

  • La función SetIoRateControlInformationJobObject requiere que el miembro BaseIoSize de la estructura de JOBOBJECT_IO_RATE_CONTROL_INFORMATION que pase a la función es 0.
  • El método QueryIoRateControlInformationJobObject establece el miembro BaseIoSize de esta estructura en 0 si el volumen que especifica el miembro VolumeName no admite el control de la velocidad de E/S.
  • El método QueryIoRateControlInformationJobObject establece el miembro BaseIoSize de esta estructura en el tamaño base de la unidad de E/S normalizada si el volumen que especifica el miembro VolumeName admite el control de la velocidad de E/S.
Para consultar el tamaño base de la unidad de E/S normalizada sin crear un trabajo, llame a QueryIoRateControlInformationJobObject con el parámetro hJob establecido en NULL desde un proceso que no está asociado a un trabajo.

ControlFlags

Directiva para el control de la tasa de E/S. Este miembro puede ser uno de los siguientes valores.

Valor Significado
JOB_OBJECT_IO_RATE_CONTROL_ENABLE
0x1
 Activa el control de la velocidad de E/S para el trabajo cuando esta estructura se pasa a la función SetIoRateControlInformationJobObject . Indica que el control de la tasa de E/S del trabajo se activa cuando se usa esta estructura con la función QueryIoRateControlInformationJobObject .

Comentarios

Importante A partir de Windows 10, versión 1607, esta estructura ya no se admite.
 
Solo puede establecer un control de velocidad de E/S para un trabajo en una jerarquía de trabajos anidados. La configuración que especifique se aplica a ese trabajo y a los trabajos secundarios de la jerarquía de ese trabajo. La configuración no se aplica a la cadena de trabajos del trabajo primario hasta la parte superior de la jerarquía. Todavía puede cambiar la configuración del trabajo original en la jerarquía en la que establece el control de velocidad de E/S. Sin embargo, los intentos de establecer valores para el control de la tasa de E/S para cualquier otro trabajo de la jerarquía, incluidos los trabajos primarios, producen un error.

Requisitos

   
Cliente mínimo compatible Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Encabezado jobapi2.h

Consulte también

QueryIoRateControlInformationJobObject

SetIoRateControlInformationJobObject