Share via


QueryProcessCycleTime 函式 (realtimeapiset.h)

擷取指定進程所有線程的週期時間總和。

語法

BOOL QueryProcessCycleTime(
  [in]  HANDLE   ProcessHandle,
  [out] PULONG64 CycleTime
);

參數

[in] ProcessHandle

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

[out] CycleTime

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

傳回值

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

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

若要列舉系統中的進程,請使用 EnumProcesses 函式。

若要編譯使用此函式的應用程式,請將_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

QueryThreadCycleTime