<Return[PQ]><Top>

PdhGetRawCounterValue

Declare Sub Api_PdhGetRawCounterValue Lib "pdh" Alias "PdhGetRawCounterValue" (ByRef hCounter As hCounter, ByRef lpdwType&, ByRef pValue As PPDH_RAW_COUNTER)

Declare Sub PdhGetRawCounterValue Lib "pdh" (ByRef hCounter As hCounter, ByRef lpdwType As Long, ByRef pValue As PPDH_RAW_COUNTER)

カウンタから未処理値の配列を取得する。

パラメータ
hCounter
    カウンタのハンドルを指定する。このカウンタの現在の未処理値を取得する。
lpdwType
    カウンタの種類を受け取る DWORD バッファへのポインタを指定する。このバッファが受け取るカウンタの種類については、WINPERF.H ヘ

    ッダーファイルを参照する。このパラメータは省略可能である。カウンタの種類が必要ない場合は、NULL を指定できる。
pValue
    カウンタの値を受け取るデータバッファへのポインタを指定する。

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

    エラー値                                    

説明                                                                                    

    PDH_INVALID_ARGUMENT

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

    PDH_INVALID_HANDLE

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

 

解説
    PdhGetRawCounterValue 関数を呼び出している間は、カウンタのデータがロック(保護)され、関数の処理中にデータが変更されるのを防

    ぐ。