QueryIoRateControlInformationJobObject 函数 (jobapi2.h)
获取有关作业对象的 I/O 速率控制的信息。
语法
DWORD QueryIoRateControlInformationJobObject(
[in, optional] HANDLE hJob,
[in, optional] PCWSTR VolumeName,
[out] JOBOBJECT_IO_RATE_CONTROL_INFORMATION **InfoBlocks,
[out] ULONG *InfoBlockCount
);
parameters
[in, optional] hJob
要查询信息的作业的句柄。 从 CreateJobObject 或 OpenJobObject 函数获取此句柄。 句柄必须具有 JOB_OBJECT_QUERY 访问权限。 有关访问权限的详细信息，请参阅 作业对象安全性和访问权限。
如果此值为 NULL，并且调用 QueryIoRateControlInformationJobObject 的进程与作业相关联，则该函数将使用与进程关联的作业。 如果作业嵌套在另一个作业中，则函数对进程使用即时作业。
[in, optional] VolumeName
要查询的卷的名称。 如果此值为 NULL，则该函数获取有关系统所有卷的作业的 I/O 速率控制的信息。
[out] InfoBlocks
指向 JOBOBJECT_IO_RATE_CONTROL_INFORMATION 结构的数组的指针，这些结构包含有关作业的 I/O 速率控制的信息。 代码必须通过使用数组的地址调用 FreeMemoryJobObject 函数来释放此数组的内存。
[out] InfoBlockCount
函数在 InfoBlocks 参数指向的数组中分配的JOBOBJECT_IO_RATE_CONTROL_INFORMATION结构的数目。
返回值
如果该函数成功，则返回值为非零值。
如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。
注解
重要从 Windows 10 版本 1607 开始，不再支持此函数。
要求
| 最低受支持的客户端 | Windows 10 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2016 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | jobapi2.h |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |