CounterInitialize 함수

공급자를 등록하고 카운터 집합을 초기화합니다.

구문

ULONG WINAPI CounterInitialize(void);

매개 변수

이 함수에는 매개 변수가 없습니다.

반환 값

성공에 대한 ERROR_SUCCESS 반환합니다. 그렇지 않으면 표준 Win32 오류 코드입니다.

설명

공급자가 이 함수를 호출합니다. 함수에는 PerfStartProvider 함수 및 PerfSetCounterSetInfo 함수에 대한 호출이 포함됩니다.

CTRPP 도구는 -o 인수를 지정할 때 이 인라인 함수를 생성합니다. - prefix 인수를 지정하면 함수 이름에 접두사 문자열이 포함됩니다.

-MemoryRoutines 또는 -NotificationCallback 인수를 지정하거나 공급자 요소에 대한 콜백 특성을 지정하면 CounterInitialize 서명이 다음과 같이 변경됩니다.

ULONG WINAPI CounterInitialize(
    __in_opt PERFLIBREQUEST NotificationCallback,
    __in_opt PERF_MEM_ALLOC MemoryAllocationFunction,
    __in_opt PERF_MEM_FREE MemoryFreeFunction,
    __inout_opt PVOID MemoryFunctionContext
);

각 항목이 나타내는 의미는 다음과 같습니다.

NotificationCallback

소비자 요청 알림을 받기 위해 구현하는 ControlCallback 콜백 함수의 이름입니다(예: 쿼리에서 카운터를 추가하거나 제거하는 요청). ControlCallback 콜백 함수를 구현하지 않으면 NULL로 설정합니다.

MemoryAllocationFunction

PERFLIB가 메모리를 할당하기 위해 호출하는 AllocateMemory 콜백 함수의 이름입니다. -MemoryRoutines 인수를 지정하지 않은 경우 NULL로 설정합니다.

MemoryFreeFunction

AllocateMemory 함수를 사용하여 할당된 메모리를 해제하기 위해 PERFLIB에서 호출하는 FreeMemory 콜백 함수의 이름입니다. MemoryAllocationFunction이 NULL인 경우 NULL로 설정합니다.

MemoryFunctionContext

메모리 할당 및 사용 가능한 루틴에 전달할 컨텍스트 정보입니다. NULL일 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]