다음을 통해 공유


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 버전 1607부터 이 함수는 더 이상 지원되지 않습니다.
 

요구 사항

   
지원되는 최소 클라이언트 Windows 10 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 jobapi2.h
라이브러리 Kernel32.lib
DLL Kernel32.dll

참고 항목

FreeMemoryJobObject

JOBOBJECT_IO_RATE_CONTROL_INFORMATION

SetIoRateControlInformationJobObject