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 參數。

傳回值

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

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

備註

若要編譯使用此函式的應用程式，請設定 _WIN32_WINNT >= 0x0601。 如需詳細資訊，請參閱 使用 Windows 標頭。

規格需求

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

另請參閱

處理器群組

QueryIdleProcessorCycleTime