QueryIdleProcessorCycleTimeEx 함수(realtimeapiset.h)

지정된 프로세서 그룹의 각 논리 프로세서에서 유휴 스레드에 대해 누적된 주기 시간을 검색합니다.

구문

BOOL QueryIdleProcessorCycleTimeEx(
  [in]      USHORT   Group,
  [in, out] PULONG   BufferLength,
  [out]     PULONG64 ProcessorIdleCycleTime
);

[in] Group

주기 시간을 검색할 프로세서 그룹의 수입니다.

[in, out] BufferLength

입력 시 ProcessorIdleCycleTime 버퍼의 크기를 바이트 단위로 지정합니다. 이 버퍼는 그룹의 프로세서 수의 8배가 될 것으로 예상됩니다.

출력에서 는 버퍼에 기록된 요소의 수를 지정합니다. 버퍼 크기가 충분하지 않으면 함수가 실패하고 이 매개 변수는 버퍼의 필요한 길이를 받습니다.

[out] ProcessorIdleCycleTime

각 유휴 스레드에서 사용하는 CPU 클록 주기의 수입니다. 이 매개 변수가 NULL인 경우 함수는 BufferLength 매개 변수를 필요한 길이로 업데이트합니다.

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError를 사용합니다.

이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT >= 0x0601 설정합니다. 자세한 내용은 Windows 헤더 사용을 참조하세요.

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	realtimeapiset.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll