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
카운터 집합 instance 포함하는 PERF_COUNTERSET_INSTANCE 구조체입니다. PerfCreateInstance 함수는 이 포인터를 반환합니다.
[in] CounterId
instance 블록에서 업데이트할 카운터를 고유하게 식별하는 식별자입니다. 식별자는 카운터 요소의 id 특성에 정의되며 instance 블록에 있는 PERF_COUNTER_INFO 구조체 중 하나의 CounterId 멤버와 일치해야 합니다. CTRPP 도구가 생성한 카운터 ID 상수를 사용합니다. 상수의 이름은 카운터 요소의 기호 특성을 참조하세요.
Windows Vista: 카운터 ID 상수를 사용할 수 없습니다.
[in] Value
카운터를 증분할 값입니다.
반환 값
함수가 성공하면 ERROR_SUCCESS 반환합니다.
함수가 실패하면 반환 값은 시스템 오류 코드입니다.
설명
원시 카운터 데이터를 증가시키는 편리한 함수입니다. 원시 카운터 데이터를 직접 증가하려면 PERF_COUNTER_INFO 구조의 Offset 멤버를 사용하여 특정 카운터에 대한 원시 카운터 데이터에 액세스합니다. PERF_COUNTERSET_INSTANCE 구조 블록에는 하나 이상의 카운터 정보 구조가 포함되어 있습니다.
PerfSetULongLongCounterValue 함수를 사용하여 처음에 카운터 값을 설정합니다.
카운터 값이 8 바이트 부호 없는 정수의 최대 크기를 초과하면 카운터 값이 오버플로됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | perflib.h |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |
추가 정보
PerfDecrementULongLongCounterValue