PerfSetULongLongCounterValue 函式 (perflib.h)

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

語法

ULONG PerfSetULongLongCounterValue(
  [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

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

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

[in] Value

新的8位元組計數器值。

傳回值

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

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

備註

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

您可以使用 PerfIncrementULongLongCounterValue 和 PerfDecrementULongLongCounterValue 函式分別遞增或遞減計數器值。

規格需求

另請參閱

PerfDecrementULongLongCounterValue

PerfIncrementULongLongCounterValue

PerfSetCounterRefValue

PerfSetULongCounterValue