PdhFormatFromRawValue 関数 (pdh.h)

  • [アーティクル]

指定された生カウンター値の表示可能な値を計算します。

構文

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」を参照してください。 レート カウンターなど、一部のカウンターでは、表示可能な値を計算するために 2 つの生の値が必要です。 カウンター型に 2 番目の値が必要ない場合は、このパラメーターを NULL に設定 します。 この値は、2 つの生の値の古い値である必要があります。

[out] pFmtValue

計算されたカウンター値を受け取る PDH_FMT_COUNTERVALUE 構造体。

戻り値

関数が成功すると、ERROR_SUCCESSが返されます。

関数が失敗した場合、戻り値は システム エラー コード または PDH エラー コードです。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー pdh.h
Library Pdh.lib
[DLL] Pdh.dll

こちらもご覧ください

PDH_FMT_COUNTERVALUE

PDH_RAW_COUNTER

PdhGetCounterInfo

PdhGetCounterTimeBase

PdhGetRawCounterValue

PdhReadRawLogRecord