共用方式為

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 函式。

請勿嘗試將 queryThreadCycle Time 傳回的 CPU 時鐘週期轉換為經過的時間。 此函式會使用 CPU 所提供的定時器服務，其實作可能會有所不同。 例如，某些 CPU 在變更 CPU 執行頻率時，會改變定時器的頻率，而其他 CPU 則會以固定速率離開定時器。 每個 CPU 的行為說明於 CPU 廠商所提供的檔中。

若要編譯使用此函式的應用程式，請將_WIN32_WINNT定義為0x0600或更新版本。

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 realtimeapiset.h （包括 Windows 7 上的 Windows.h、Windows Server 2008 Windows Server 2008 R2）
連結庫 Mincore.lib
DLL Kernel32.dll

另請參閱

QueryIdleProcessorCycleTime

QueryProcessCycleTime