PerfDecrementULongLongCounterValue 函式 (perflib.h)
遞減其值為8位元組無符號整數的計數器值。 提供者會使用此函式。
語法
ULONG PerfDecrementULongLongCounterValue(
[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 函式一開始設定計數器值。
請注意，當計數器值遞減超過零時，計數器值將會下溢。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | perflib.h |
| 程式庫 | Advapi32.lib |
| Dll | Advapi32.dll |
另請參閱
PerfDecrementULongCounterValue