PerfIncrementULongLongCounterValue 函式 (perflib.h)

遞增計數器的值，其值為8位元組無符號整數。 提供者會使用此函式。

語法

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

參數

[in] Provider

提供者的句柄。 使用 CTRPP 工具為您產生的句柄變數。 如需變數的名稱，請參閱提供者專案的符號屬性。

Windows Vista： PerfStartProvider 函式會傳回句柄。

[in] Instance

包含計數器集合實例 的PERF_COUNTERSET_INSTANCE 結構。 PerfCreateInstance 函式會傳回此指標。

[in] CounterId

可唯一識別實例區塊中要更新之計數器的標識碼。 標識元定義於計數器專案的 id 屬性中，而且必須符合實例區塊中其中一個PERF_COUNTER_INFO結構的 CounterId 成員。 使用 CTRPP 工具為您產生的計數器識別碼常數。 如需常數的名稱，請參閱計數器專案的符號屬性。

Windows Vista： 計數器標識碼常數無法使用。

[in] Value

要遞增計數器的值。

傳回值

如果函式成功，則會傳回ERROR_SUCCESS。

如果函式失敗，則傳回值是 系統錯誤碼。

備註

這是遞增原始計數器數據的便利函式。 若要自行遞增原始計數器數據，請使用 PERF_COUNTER_INFO 結構的 Offset 成員來存取特定計數器的原始計數器數據。 PERF_COUNTERSET_INSTANCE結構區塊包含一或多個計數器信息結構。

使用 PerfSetULongLongCounterValue 函式一開始設定計數器值。

請注意，當計數器值遞增超過8位元組無符號整數的大小上限時，計數器值將會溢位。

規格需求

另請參閱

PerfDecrementULongLongCounterValue

PerfIncrementULongCounterValue

PerfSetULongLongCounterValue