QueryIoRateControlInformationJobObject 函数 (jobapi2.h)

Windows 10 版本 1607 及更新版本:不支持此函数。

获取有关作业对象的 I/O 速率控件的信息。

语法

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

参数

[in, optional] hJob

要查询信息的作业句柄。 从 CreateJobObjectOpenJobObject 函数中获取此句柄。 句柄必须具有 JOB_OBJECT_QUERY 访问权限。 有关访问权限的详细信息,请参阅 作业对象安全和访问权限

如果此值为 NULL,并且调用 QueryIoRateControlInformationJobObject 的进程与作业相关联,则该函数使用与进程关联的作业。 如果作业嵌套在另一个作业中,该函数将使用进程的即时作业。

[in, optional] VolumeName

要查询的卷的名称。 如果此值为 NULL,则该函数获取有关系统所有卷的作业的 I/O 速率控制的信息。

[out] InfoBlocks

指向包含作业 I/O 速率控制信息的 JOBOBJECT_IO_RATE_CONTROL_INFORMATION 结构的数组的指针。 代码必须使用数组的地址调用 FreeMemoryJobObject 函数来释放此数组的内存。

[out] InfoBlockCount

函数在 InfoBlocks 参数点的数组中分配的 JOBOBJECT_IO_RATE_CONTROL_INFORMATION 结构数。

返回值

如果函数成功,则返回值为非零。

如果函数失败,则返回值为零。 若要获取扩展的错误信息,请调用 GetLastError

要求

要求 价值
最低支持的客户端 Windows 10 [仅限桌面应用]
支持的最低服务器 Windows Server 2016 [仅限桌面应用]
目标平台 窗户
标头 jobapi2.h
Kernel32.lib
DLL Kernel32.dll

另请参阅

FreeMemoryJobObject

JOBOBJECT_IO_RATE_CONTROL_INFORMATION

SetIoRateControlInformationJobObject