PdhComputeCounterStatistics 函式 (pdh.h)

  • 發行項

從原始值數位計算計數器的統計數據。

語法

PDH_FUNCTION PdhComputeCounterStatistics(
  [in]  PDH_HCOUNTER     hCounter,
  [in]  DWORD            dwFormat,
  [in]  DWORD            dwFirstEntry,
  [in]  DWORD            dwNumEntries,
  [in]  PPDH_RAW_COUNTER lpRawValueArray,
  [out] PPDH_STATISTICS  data
);

參數

[in] hCounter

您要計算統計數據的計數器句柄。 PdhAddCounter 函式會傳回此句柄。

[in] dwFormat

決定格式化值的數據類型。 指定下列其中一個值。

值 意義
PDH_FMT_DOUBLE
 將計算值傳回為雙精確度浮點實數。
PDH_FMT_LARGE
 將匯出值傳回為 64 位整數。
PDH_FMT_LONG
 將匯出值傳回為長整數。
 

您可以使用位包含 OR 運算子 (|) 結合數據類型與下列其中一個縮放比例。

值 意義
PDH_FMT_NOSCALE
 請勿在計算中套用計數器的縮放比例。
PDH_FMT_NOCAP100
 例如，大於 100 (的計數器值，在多處理器) 計算機上測量處理器負載的計數器值將不會重設為 100。 默認行為是計數器值上限為100。
PDH_FMT_1000
 將最終值乘以 1,000。

[in] dwFirstEntry

用來開始計算之第一個原始計數器值之以零起始的索引。 索引值必須指向緩衝區中最舊的專案。 函式會從這個項目開始，並掃描緩衝區，並將最後一個專案包裝回緩衝區的開頭，並向上包裝至 dwFirstEntry-1 專案，這假設為最新的或最新的數據。

[in] dwNumEntries

lpRawValueArray 緩衝區中的原始計數器值數目。

[in] lpRawValueArray

包含 dwNumEntries 專案的PDH_RAW_COUNTER結構數位。

[out] data

接收計數器統計數據 的PDH_STATISTICS 結構。

傳回值

如果函式成功，它會傳回ERROR_SUCCESS。

如果函式失敗，傳回值為 系統錯誤碼 或 PDH 錯誤碼。 以下是可能的值。

傳回碼 Description
PDH_INVALID_ARGUMENT
 自變數不正確或格式不正確。
PDH_INVALID_HANDLE
 計數器句柄無效。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 pdh.h
程式庫 Pdh.lib
Dll Pdh.dll

另請參閱

PDH_RAW_COUNTER

PDH_STATISTICS

PdhCalculateCounterFromRawValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor