QueryProcessCycleTime 関数 (realtimeapiset.h)

  • [アーティクル]

指定したプロセスのすべてのスレッドのサイクル時間の合計を取得します。

構文

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

パラメーター

[in] ProcessHandle

プロセスのハンドル。 ハンドルには、PROCESS_QUERY_INFORMATIONまたはPROCESS_QUERY_LIMITED_INFORMATIONアクセス権が必要です。 詳細については、「 セキュリティとアクセス権の処理」を参照してください。

[out] CycleTime

プロセスのスレッドによって使用される CPU クロック サイクルの数。 この値には、ユーザー モードとカーネル モードの両方で費やされたサイクルが含まれます。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

システム内のプロセスを列挙するには、 EnumProcesses 関数を使用します。

この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNTを 0x0600 以降として定義します。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー realtimeapiset.h (Windows 7 の Windows.h、Windows Server 2008 Windows Server 2008 R2 を含む)
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

QueryIdleProcessorCycleTime

QueryThreadCycleTime