<Return[PQ]><Top>

PdhFormatFromRawValue

Declare Sub Api_PdhFormatFromRawValue Lib "pdh" Alias "PdhFormatFromRawValue" (ByVal dwCounterType&, ByVal dwFormat&, ByRef pTimeBase#, ByRef pRawValue1 As PPDH_RAW_COUNTER, ByRef pRawValue2 As PPDH_RAW_COUNTER, ByRef pFmtValue As PPDH_FMT_COUNTERVALUE)

Declare Sub PdhFormatFromRawValue Lib "pdh" (ByVal dwCounterType As Long, ByVal dwFormat As Long, ByRef pTimeBase As Double, ByRef pRawValue1 As PPDH_RAW_COUNTER, ByRef pRawValue2 As PPDH_RAW_COUNTER, ByRef pFmtValue As PPDH_FMT_COUNTERVALUE)

1 つの未処理のパフォーマンスデータ値を特定の形式に変換する。また、形式の変換にタイムベースが使われる場合は、2 つのパフォーマンスデータ値を変換する。

パラメータ
dwCounterType

    カウンタの種類を指定する。次の値が定義されている。

    値                                

意味                                                                                      

    PDH_FMT_DOUBLE

未処理のカウンタ値のデータ型は倍精度浮動小数点実数である。

    PDH_FMT_LARGE

未処理のカウンタ値のデータ型は 64 ビット整数である。

    PDH_FMT_LONG

未処理のカウンタ値のデータ型は長整数数である。

dwFormat
    未処理パフォーマンスデータの変換後の形式を指定する。次の値が定義されている。

    値                                

意味                                                                                      

    PDH_FMT_DOUBLE

未処理のカウンタ値のデータ型は倍精度浮動小数点実数である。

    PDH_FMT_LARGE

未処理のカウンタ値のデータ型は 64 ビット整数である。

    PDH_FMT_LONG

未処理のカウンタ値のデータ型は長整数数である。

    前記で選択した値に次のいずれかのスケールフラグを OR 演算子で結合できる。

    フラグ                              

意味                                                

    PDH_FMT_NOSCALE

計算にカウンタのスケールを使わない。

    PDH_FMT_1000

最終的な値に 1000 を掛ける。

pTimeBase
    変換にタイムベースが必要なときは、そのタイムベースへのポインタを指定する。形式の変換にタイムベースの情報が不要な場合は、この

    パラメータの値は無視される。
pRawValue1
    未処理のパフォーマンスデータ値が入った 構造体へのポインタを指定する。
pRawValue2
    形式の変換に必要な場合は、2 番目の未処理のパフォーマンスデータ値が入った PPDH_RAW_COUNTER 構造体へのポインタを指定す

    る。2 番目の未処理の値が不要なときは、NULL を指定する。
pFmtValue
    形式変換後のパフォーマンスデータを受け取る変数へのポインタを指定する。

戻り値
    関数が成功すると、ERROR_SUCCESS が返る。
    関数が失敗すると、PDHMSG.H ヘッダーファイルで定義されている PDH エラーステータスが返る。次のいずれかの値が返る

    エラー値                                   

説明                                                              

    PDH_INVALID_ARGUMENT

引数が正しくないか、引数の形式が正しくない。

    PDH_INVALID_HANDLE

カウンタのハンドルが無効である。