PerfSetULongCounterValue 関数 (perflib.h)

値が 4 バイト符号なし整数であるカウンターの値を更新します。 プロバイダーはこの関数を使用します。

構文

ULONG PerfSetULongCounterValue(
  [in] HANDLE                    Provider,
  [in] PPERF_COUNTERSET_INSTANCE Instance,
  [in] ULONG                     CounterId,
  [in] ULONG                     Value
);

パラメーター

[in] Provider

プロバイダーのハンドル。 CTRPP ツールによって生成されたハンドル変数を使用します。 変数の名前については、プロバイダー要素の symbol 属性を参照してください。

Windows Vista: PerfStartProvider 関数はハンドルを返します。

[in] Instance

カウンター セット インスタンスを含む PERF_COUNTERSET_INSTANCE 構造体。 PerfCreateInstance 関数は、このポインターを返します。

[in] CounterId

インスタンス ブロックで更新するカウンターを一意に識別する識別子。 識別子は counter 要素の id 属性で定義され、インスタンス ブロック内のPERF_COUNTER_INFO構造体の 1 つの CounterId メンバーと一致する必要があります。 CTRPP ツールによって生成されたカウンター ID 定数を使用します。 定数の名前については、counter 要素の symbol 属性を参照してください。

Windows Vista: カウンター ID 定数は使用できません。

[in] Value

新しい 4 バイト カウンター値。

戻り値

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

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

注釈

これは、生のカウンター データを設定するための便利な関数です。 生カウンター データを自分で更新するには、PERF_COUNTER_INFO 構造体の Offset メンバーを使用して、特定のカウンターの生カウンター データにアクセスします。 PERF_COUNTERSET_INSTANCE構造体ブロックには、1 つ以上のカウンター情報構造体が含まれています。

PerfIncrementULongCounterValue 関数と PerfDecrementULongCounterValue 関数を使用して、カウンター値をそれぞれインクリメントまたはデクリメントできます。

要件

こちらもご覧ください

PerfDecrementULongCounterValue

PerfIncrementULongCounterValue

PerfSetCounterRefValue

PerfSetULongLongCounterValue