PdhCalculateCounterFromRawValue 函式 (pdh.h)

  • 發行項

計算兩個原始計數器值的可顯示值。

語法

PDH_FUNCTION PdhCalculateCounterFromRawValue(
  [in]  PDH_HCOUNTER          hCounter,
  [in]  DWORD                 dwFormat,
  [in]  PPDH_RAW_COUNTER      rawValue1,
  [in]  PPDH_RAW_COUNTER      rawValue2,
  [out] PPDH_FMT_COUNTERVALUE fmtValue
);

參數

[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] rawValue1

用來計算可顯示計數器值的原始計數器值。 如需詳細資訊，請參閱 PDH_RAW_COUNTER 結構。

[in] rawValue2

用來計算可顯示計數器值的原始計數器值。 如需詳細資訊，請參閱 PDH_RAW_COUNTER。 例如，某些計數器 (，速率計數器) 需要兩個原始值來計算可顯示的值。 如果計數器類型不需要第二個值，請將此參數設定為 NULL。 此值必須是兩個原始值的較舊值。

[out] fmtValue

接收計算計數器值的 PDH_FMT_COUNTERVALUE 結構。

傳回值

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

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

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

備註

若要從查詢擷取目前的原始計數器值，請呼叫 PdhGetRawCounterValue 函式。

規格需求

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

另請參閱

PDH_FMT_COUNTERVALUE

PDH_RAW_COUNTER

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor