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 成員會設定為一個處理器的週期時間。

[in, out] ReturnedLength

緩衝區的大小，以位元組為單位。 當函式傳回時，此參數包含寫入 Buffer 的位元元組數目。 如果緩衝區對數據而言太小，則函式會失敗並ERROR_INSUFFICIENT_BUFFER，並將 ReturnedLength 參數設定為所需的緩衝區大小。

傳回值

如果函式成功，則傳回值是非零值。

如果此函式失敗，則傳回值為零。 若要取得擴充錯誤資訊，請使用 GetLastError。

如果錯誤值 ERROR_INSUFFICIENT_BUFFER，ReturnedLength 參數會包含所需的緩衝區大小。

備註

若要編譯使用此函式的應用程式，請將_WIN32_WINNT定義為0x0601或更新版本。 如需詳細資訊，請參閱 使用 Windows 標頭。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 sysinfoapi.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

處理器群組