Share via

FormatFromRawValue 関数

  • [アーティクル]

1 つの生のパフォーマンス データ値が指定した形式に変換されます。この形式変換が時間ベースである場合は、2 つの生のパフォーマンス データ値が変換されます。

Note

この 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 ビット整数として返します。

上の値のいずれかを、次のいずれかのスケール フラグと OR 演算できます。

定数 [値] 説明
PDH_FMT_NOSCALE 0x00001000 カウンターのスケール ファクターを適用しません。
PDH_FMT_1000 0x00002000 最終的な値を 1,000 で乗算します。

pTimeBase
[in] 時間基準 (形式変換に必要な場合) へのポインター。 形式変換に時間基準の情報が不要な場合、このパラメーターの値は無視されます。

pRawValue1
[in] 生のパフォーマンス値を表す PDH_RAW_COUNTER 構造体へのポインター。

pRawValue2
[in] 2 番目の生のパフォーマンス値を表す PDH_RAW_COUNTER 構造体へのポインター。 2 番目の生のパフォーマンス値が不要な場合、このパラメーターは 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 以降で使用可能

関連項目