QueryThreadCycleTime 함수(realtimeapiset.h)

지정된 스레드의 주기 시간을 검색합니다.

구문

BOOL QueryThreadCycleTime(
  [in]  HANDLE   ThreadHandle,
  [out] PULONG64 CycleTime
);

매개 변수

[in] ThreadHandle

스레드에 대한 핸들입니다. 핸들에는 PROCESS_QUERY_INFORMATION 또는 PROCESS_QUERY_LIMITED_INFORMATION 액세스 권한이 있어야 합니다. 자세한 내용은 프로세스 보안 및 액세스 권한을 참조하세요.

[out] CycleTime

스레드에서 사용하는 CPU 클록 주기의 수입니다. 이 값에는 사용자 모드와 커널 모드 모두에서 소비되는 주기가 포함됩니다.

반환 값

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

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

설명

프로세스의 스레드를 열거하려면 Thread32First 및 Thread32Next 함수를 사용합니다. 스레드 식별자에 대한 스레드 핸들을 얻으려면 OpenThread 함수를 사용합니다.

QueryThreadCycleTime에서 반환된 CPU 클록 주기를 경과된 시간으로 변환하지 마세요. 이 함수는 구현에 따라 달라질 수 있는 CPU에서 제공하는 타이머 서비스를 사용합니다. 예를 들어 일부 CPU는 CPU가 실행되는 빈도를 변경할 때 타이머의 빈도를 변경하고 다른 CPU는 고정 속도로 둡니다. 각 CPU의 동작은 CPU 공급업체에서 제공하는 설명서에 설명되어 있습니다.

이 함수를 사용하는 애플리케이션을 컴파일하려면 _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

참고 항목

QueryIdleProcessorCycleTime

QueryProcessCycleTime