Share via

QueryThreadCycleTime 函式 (realtimeapiset.h)

  • 發行項

擷取指定線程的周期時間。

語法

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

參數

[in] ThreadHandle

線程的句柄。 句柄必須具有PROCESS_QUERY_INFORMATION或PROCESS_QUERY_LIMITED_INFORMATION訪問許可權。 如需詳細資訊，請參閱 處理安全性和訪問許可權。

[out] CycleTime

線程所使用的 CPU 時鐘週期數目。 此值包含使用者模式和核心模式所花費的週期。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 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)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

QueryIdleProcessorCycleTime

QueryProcessCycleTime