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 ヘッダーの使用」を参照してください。

要件

関連項目

プロセッサ グループ