QueryIdleProcessorCycleTime 함수(realtimeapiset.h)

시스템에 있는 각 프로세서의 유휴 스레드에 대한 주기 시간을 검색합니다.

64개 이상의 프로세서가 있는 시스템에서 이 함수는 호출 스레드가 할당된 프로세서 그룹의 각 프로세서의 유휴 스레드에 대한 주기 시간을 검색합니다. QueryIdleProcessorCycleTimeEx 함수를 사용하여 특정 프로세서 그룹에 대한 각 논리 프로세서의 유휴 스레드에 대한 주기 시간을 검색합니다.

구문

BOOL QueryIdleProcessorCycleTime(
  [in, out] PULONG   BufferLength,
  [out]     PULONG64 ProcessorIdleCycleTime
);

매개 변수

[in, out] BufferLength

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

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

[out] ProcessorIdleCycleTime

각 유휴 스레드에서 사용하는 CPU 클록 주기의 수입니다. 이 버퍼는 시스템 크기의 프로세서 수의 8배여야 합니다.

반환 값

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

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT 0x0600 이상으로 정의합니다.

요구 사항

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

참고 항목

프로세서 그룹

QueryIdleProcessorCycleTimeEx

QueryProcessCycleTime

QueryThreadCycleTime