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構造体の数。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
要件
サポートされている最小のクライアント | Windows 10 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2016 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | jobapi2.h |
Library | Kernel32.lib |
[DLL] | Kernel32.dll |