<Return[PQ]><Top>

PdhGetRawCounterArray

Declare Sub Api_PdhGetRawCounterArray Lib "pdh" Alias "PdhGetRawCounterArray" (ByRef hCounter As hCounter, ByRef lpdwBufferSize&, ByRef lpdwItemCount&, ByRef ItemBuffer As PPDH_RAW_COUNTER_ITEM_A)

Declare Sub PdhGetRawCounterArray Lib "pdh" (ByRef hCounter As hCounter, ByRef lpdwBufferSize As Long, ByRef lpdwItemCount As Long, ByRef ItemBuffer As PPDH_RAW_COUNTER_ITEM_A)

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

パラメータ
hCounter
    カウンタのハンドルを指定する。このカウンタから現在の未処理値を取得する。
lpdwBufferSize
    ItemBuffer がパラメータ指すバッファのサイズ(バイト数)を指定する。
lpdwItemCount
    ItemBuffer がパラメータ指すバッファに格納された値の数を受け取る、変数へのポインタを指定する。
ItemBuffer
   現在のカウンタ値を受け取るデータバッファへのポインタを指定する。

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

    エラー値                                    

説明                                                                                    

    PDH_INVALID_ARGUMENT

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

    PDH_MORE_DATA

バッファのサイズが不十分で、カウンタデータを格納できなかった。

    PDH_INVALID_HANDLE

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

　

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