Compartir a través de

Función QueryIoRateControlInformationJobObject (jobapi2.h)

  • Artículo

Windows 10, versión 1607 y versiones posteriores: esta función no se admite.

Obtiene información sobre el control de la tasa de E/S de un objeto de trabajo.

Sintaxis

DWORD QueryIoRateControlInformationJobObject(
  [in, optional] HANDLE                                hJob,
  [in, optional] PCWSTR                                VolumeName,
  [out]          JOBOBJECT_IO_RATE_CONTROL_INFORMATION **InfoBlocks,
  [out]          ULONG                                 *InfoBlockCount
);

Parámetros

[in, optional] hJob

Identificador del trabajo que se va a consultar para obtener información. Obtenga este identificador de la función CreateJobObject o OpenJobObject. El identificador debe tener el derecho de acceso JOB_OBJECT_QUERY. Para obtener más información sobre los derechos de acceso, vea Derechos de acceso y seguridad de objetos de trabajo.

Si este valor es NULL y el proceso que llama a QueryIoRateControlInformationJobObject está asociado a un trabajo, la función usa el trabajo asociado al proceso. Si el trabajo está anidado dentro de otro trabajo, la función usa el trabajo inmediato para el proceso.

[in, optional] VolumeName

Nombre del volumen que se va a consultar. Si este valor es NULL, la función obtiene la información sobre el control de velocidad de E/S del trabajo para todos los volúmenes del sistema.

[out] InfoBlocks

Puntero a la matriz de estructuras de JOBOBJECT_IO_RATE_CONTROL_INFORMATION que contienen la información sobre el control de velocidad de E/S para el trabajo. El código debe liberar la memoria de esta matriz llamando a la función FreeMemoryJobObject con la dirección de la matriz.

[out] InfoBlockCount

Número de estructuras JOBOBJECT_IO_RATE_CONTROL_INFORMATION que la función asignó en la matriz a la que apunta el parámetro InfoBlocks.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 10 [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2016 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de jobapi2.h
biblioteca de Kernel32.lib
DLL de Kernel32.dll

Consulte también

freeMemoryJobObject

JOBOBJECT_IO_RATE_CONTROL_INFORMATION

SetIoRateControlInformationJobObject