FormatFromRawValue 函式
將一個原始效能資料值轉換為指定的格式，或轉換為兩個原始效能資料值 (若格式轉換是以時間為基礎)。
注意
此 API 僅供內部使用。 不是要讓您在開發人員程式碼中使用。
語法
int FormatFromRawValue (
[in] uint dwCounterType,
[in] uint dwFormat,
[in] long* pTimeBase,
[in] PDH_RAW_COUNTER* pRawValue1,
[in] PDH_RAW_COUNTER* pRawValue2,
[out] PDH_FMT_COUNTERVALUE* pFmtValue
);
參數
dwCounterType
[in] 計數器類型。 如需計數器類型的清單，請參閱 WMI 效能計數器類型。 dwCounterType 可以是 PERF_LARGE_RAW_FRACTION 和 PERF_LARGE_RAW_BASE 以外的任何計數器類型。
dwFormat
[in] 欲轉換原始效能資料的格式。 它可能是下列其中一個值：
| 常數 | 值 | 描述 |
|---|---|---|
PDH_FMT_DOUBLE |
0x00000200 | 將計算值傳回為雙精確度浮點值。 |
PDH_FMT_LARGE |
0x00000400 | 將匯出值傳回為 64 位整數。 |
PDH_FMT_LONG |
0x00000100 | 將匯出值傳回為 32 位整數。 |
上述其中一個值可以是具有下列其中一個縮放旗標的 ORed：
| 常數 | 值 | 描述 |
|---|---|---|
PDH_FMT_NOSCALE |
0x00001000 | 請勿套用計數器的縮放比例。 |
PDH_FMT_1000 |
0x00002000 | 將最終值乘以 1,000。 |
pTimeBase
[in] 若需要格式轉換，則為時間基底的指標。 若格式轉換不需要時間基底資訊，則會忽略此參數的值。
pRawValue1
[in] PDH_RAW_COUNTER 結構的指標，表示原始效能值。
pRawValue2
[in] PDH_RAW_COUNTER 結構的指標，表示第二個原始效能值。 若無需第二個原始效能值，這個參數應該是 null。
pFmtValue
[out] 接收格式化效能值的 PDH_FMT_COUNTERVALUE 結構指標。
傳回值
此函式會傳回下列值：
| 常數 | 值 | 描述 |
|---|---|---|
ERROR_SUCCESS |
0 | 函式呼叫成功。 |
PDH_INVALID_ARGUMENT |
0xC0000BBD | 必要的引數遺失或不正確。 |
PDH_INVALID_HANDLE |
0xC0000BBC | 控制代碼不是有效的 PDH 物件。 |
備註
此函式會包裝 FormatFromRawValue 函式的呼叫。
規格需求
平台：請參閱系統需求。
程式庫：PerfCounter.dll
.NET Framework版本：自 4.7.2 起可用
