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 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | realtimeapiset.h (Windows.h を含む) |
| ライブラリ | Mincore.lib |
| DLL | Kernel32.dll |