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
);
參數
[in, optional] hJob
要查詢資訊的作業控制碼。 從 CreateJobObject 或 OpenJobObject 函式取得此控制碼。 控制碼必須具有 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 1607 版開始，不再支援此函式。
需求
| 最低支援的用戶端 | Windows 10 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | jobapi2.h |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |