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 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	realtimeapiset.h (Windows 7 の Windows.h、Windows Server 2008 Windows Server 2008 R2 を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll

関連項目

プロセッサ グループ

QueryIdleProcessorCycleTimeEx

QueryProcessCycleTime

QueryThreadCycleTime