다음을 통해 공유


PerfDecrementULongCounterValue 함수(perflib.h)

값이 4 바이트 부호 없는 정수인 카운터의 값을 감소합니다. 공급자는 이 함수를 사용합니다.

구문

ULONG PerfDecrementULongCounterValue(
  [in] HANDLE                    Provider,
  [in] PPERF_COUNTERSET_INSTANCE Instance,
  [in] ULONG                     CounterId,
  [in] ULONG                     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 구조 블록에는 하나 이상의 카운터 정보 구조가 포함되어 있습니다.

처음에 카운터 값을 설정하려면 PerfSetULongCounterValue 함수를 사용합니다.

카운터 값이 0을 넘으면 카운터 값이 언더플로됩니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 perflib.h
라이브러리 Advapi32.lib
DLL Advapi32.dll

추가 정보

PerfDecrementULongLongCounterValue

PerfIncrementULongCounterValue

PerfSetULongCounterValue