次の方法で共有


QueryIdleProcessorCycleTime 関数 (realtimeapiset.h)

システム内の各プロセッサのアイドル 状態のスレッドのサイクル時間を取得します。

64 プロセッサを超えるシステムでは、この関数は、呼び出し元のスレッドが割り当てられている プロセッサ グループ内の各プロセッサのアイドル 状態のスレッドのサイクル時間を取得します。 QueryIdleProcessorCycleTimeEx 関数を使用して、特定のプロセッサ グループの各論理プロセッサでアイドル状態のスレッドのサイクル時間を取得します。

構文

BOOL QueryIdleProcessorCycleTime(
  [in, out] PULONG   BufferLength,
  [out]     PULONG64 ProcessorIdleCycleTime
);

パラメーター

[in, out] BufferLength

入力時に、ProcessorIdleCycleTime バッファーのサイズをバイト単位で指定します。 このバッファーは、グループ内のプロセッサ数の 8 倍になると予想されます。

出力時に、バッファーに書き込まれる要素の数を指定します。 バッファー サイズが十分でない場合、関数は失敗し、このパラメーターはバッファーの必要な長さを受け取ります。

[out] ProcessorIdleCycleTime

各アイドル スレッドで使用される CPU クロック サイクルの数。 このバッファーは、システム内のプロセッサのサイズの 8 倍である必要があります。

戻り値

関数が成功した場合、戻り値は 0 以外です。

関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

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

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー realtimeapiset.h (Windows 7、Windows Server 2008 Windows Server 2008 R2 の Windows.h を含む)
ライブラリ Mincore.lib
DLL Kernel32.dll

関連項目

プロセッサ グループの

QueryIdleProcessorCycleTimeEx

QueryProcessCycleTime

QueryThreadCycleTime の