PerfDecrementULongCounterValue 関数 (perflib.h)

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

構文

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

パラメーター

[in] Provider

プロバイダーのハンドル。 CTRPP ツールによって生成されたハンドル変数を使用します。 変数の名前については、provider 要素の 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

カウンターをデクリメントする値。

戻り値

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

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

注釈

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

カウンター値を最初に設定するには、 PerfSetULongCounterValue 関数を使用します。

カウンター値が 0 を超えると、カウンター値がアンダーフローされることに注意してください。

要件

こちらもご覧ください

PerfDecrementULongLongCounterValue

PerfIncrementULongCounterValue

PerfSetULongCounterValue