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
計算値のデータ型を決定します。 次のいずれかの値を指定します。
| 値 | 意味 |
|---|---|
|
計算された値を倍精度浮動小数点実数として返します。 |
|
計算された値を 64 ビット整数として返します。 |
|
計算された値を長整数として返します。 |
ビットごとの包括 OR 演算子 (|) を使用して、データ型を次のいずれかのスケーリング 要因と組み合わせることができます。
[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 |