QueryIdleProcessorCycleTimeEx 関数 (realtimeapiset.h)

指定したプロセッサグループ内の各論理プロセッサでアイドル状態のスレッドの累積サイクル時間を取得します。

構文

BOOL QueryIdleProcessorCycleTimeEx(
  [in]      USHORT   Group,
  [in, out] PULONG   BufferLength,
  [out]     PULONG64 ProcessorIdleCycleTime
);

[in] Group

サイクル時間を取得するプロセッサグループの番号。

[in, out] BufferLength

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

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

[out] ProcessorIdleCycleTime

各アイドルスレッドで使用される CPU クロックサイクルの数。このパラメーターが NULL の場合、関数は BufferLength パラメーターを必要な長さで更新します。

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

関数が失敗した場合は、0 を返します。拡張エラー情報を取得するには、 GetLastError を使用します。

この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT >= 0x0601を設定します。詳細については、「 Windows ヘッダーの使用」を参照してください。

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