pdhFormatFromRawValue 函式 (pdh.h)

發行項
03/01/2024

計算指定原始計數器值的可顯示值。

語法

PDH_FUNCTION PdhFormatFromRawValue(
  [in]  DWORD                 dwCounterType,
  [in]  DWORD                 dwFormat,
  [in]  LONGLONG              *pTimeBase,
  [in]  PPDH_RAW_COUNTER      pRawValue1,
  [in]  PPDH_RAW_COUNTER      pRawValue2,
  [out] PPDH_FMT_COUNTERVALUE pFmtValue
);

參數

[in] dwCounterType

計數器的類型。一般而言，您會呼叫 PdhGetCounterInfo ，在呼叫 PdhGetRawCounterValue 以擷取原始計數器值時擷取計數器類型。

如需計數器類型的清單，請參閱 Windows Server 2003 部署套件的計數器類型一節。 (常數值定義於 Winperf.h.)

請注意，您無法指定基底類型，例如PERF_LARGE_RAW_BASE。

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

視需要轉換格式時，時間基底的指標。若格式轉換不需要時間基底資訊，則會忽略此參數的值。若要擷取計數器的時間基底，請呼叫 PdhGetCounterTimeBase。

[in] pRawValue1

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

[in] pRawValue2

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

[out] pFmtValue

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

傳回值

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

如果函式失敗，傳回值為系統錯誤碼或 PDH 錯誤碼。

規格需求

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