GetProcessorSystemCycleTime 関数 (sysinfoapi.h)

プロセッサがアクティブになってから、指定されたプロセッサ グループ内の各プロセッサが遅延プロシージャ 呼び出し (DPC) と割り込みサービス ルーチン (ISR) の実行に費やしたサイクル時間を取得します。

構文

BOOL GetProcessorSystemCycleTime(
  [in]      USHORT                                   Group,
  [out]     PSYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION Buffer,
  [in, out] PDWORD                                   ReturnedLength
);

パラメーター

[in] Group

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

[out] Buffer

グループ内の各プロセッサのSYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION構造体を受け取るバッファーへのポインター。 出力時に、この構造体の DWORD64 CycleTime メンバーは、1 つのプロセッサのサイクル時間に設定されます。

[in, out] ReturnedLength

バッファーのサイズ (バイト単位)。 関数から制御が戻るときに、このパラメーターには、Bufferに書き込まれたバイト数が含まれます。 バッファーがデータに対して小さすぎる場合、関数はERROR_INSUFFICIENT_BUFFERで失敗し、ReturnedLength パラメーターを必要なバッファー サイズに設定します。

戻り値

関数が成功した場合、戻り値は 0 以外の値になります。

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

エラー値がERROR_INSUFFICIENT_BUFFERの場合、ReturnedLength パラメーターには、必要なバッファー サイズが含まれます。

備考

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

必要条件

関連項目

プロセッサ グループの