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] 将原始性能数据转换为的格式。 可以为下列值之一：
| 常数 | Value | 说明 |
|---|---|---|
PDH_FMT_DOUBLE |
0x00000200 | 以双精度浮点值形式返回计算值。 |
PDH_FMT_LARGE |
0x00000400 | 以 64 位整数形式返回计算值。 |
PDH_FMT_LONG |
0x00000100 | 以 32 位整数形式返回计算值。 |
前面的值之一可以是具有以下缩放标志之一的 ORed：
| 常数 | Value | 说明 |
|---|---|---|
PDH_FMT_NOSCALE |
0x00001000 | 不要应用计数器的缩放因子。 |
PDH_FMT_1000 |
0x00002000 | 将最终值乘以 1000。 |
pTimeBase
[in] 指向时基的指针（如果格式转换需要）。 如果格式转换不需要时基信息，则忽略此参数的值。
pRawValue1
[in] 指向表示原始性能值的 PDH_RAW_COUNTER 结构的指针。
pRawValue2
[in] 指向表示第二个原始性能值的 PDH_RAW_COUNTER 结构的指针。 如果不需要第二个原始性能值，则此参数应为 null。
pFmtValue
[out] 指向接收格式化性能值的 PDH_FMT_COUNTERVALUE 结构的指针。
返回值
此函数返回以下值：
| 常数 | Value | 说明 |
|---|---|---|
ERROR_SUCCESS |
0 | 函数调用成功。 |
PDH_INVALID_ARGUMENT |
0xC0000BBD | 必需的参数丢失或不正确。 |
PDH_INVALID_HANDLE |
0xC0000BBC | 句柄不是有效的 PDH 对象。 |
注解
此函数包装对 FormatFromRawValue 函数的调用。
要求
平台：请参阅系统要求。
库：PerfCounter.dll
.NET Framework 版本：自 4.7.2 起可用
