Функция QueryIoRateControlInformationJobObject (jobapi2.h)

Статья
01/16/2025

Windows 10 версии 1607 и более поздних версий: эта функция не поддерживается.

Получает сведения об управлении скоростью ввода-вывода для объекта задания.

Синтаксис

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

Параметры

[in, optional] hJob

Дескриптор задания для запроса информации. Получите этот дескр иптор из функции CreateJobObject или OpenJobObject. Дескриптор должен иметь право доступа JOB_OBJECT_QUERY. Дополнительные сведения о правах доступа см. в .

Если это значение равно NULL, а процесс, вызывающий QueryIoRateControlInformationJobObject, связан с заданием, функция использует задание, связанное с процессом. Если задание вложено в другое задание, функция использует немедленное задание для процесса.

[in, optional] VolumeName

Имя тома для запроса. Если это значение равно NULL, функция получает сведения об элементе управления скоростью ввода-вывода для задания для всех томов системы.

[out] InfoBlocks

Указатель на массив структур JOBOBJECT_IO_RATE_CONTROL_INFORMATION, содержащих сведения об управлении скоростью ввода-вывода для задания. Код должен освободить память для этого массива, вызвав функцию FreeMemoryJobObject с адресом массива.

[out] InfoBlockCount

Количество структур JOBOBJECT_IO_RATE_CONTROL_INFORMATION, выделенных функцией в массиве, в которой InfoBlocks точек параметров.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение ненулевое.

Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2016 [только классические приложения]
целевая платформа	Виндоус
заголовка	jobapi2.h
библиотеки	Kernel32.lib
DLL	Kernel32.dll

См. также

FreeMemoryJobObject

JOBOBJECT_IO_RATE_CONTROL_INFORMATION

SetIoRateControlInformationJobObject

Поделиться через