PerfQueryCounterInfo 함수(perflib.h)

지정된 쿼리의 카운터 사양을 가져옵니다.

구문

ULONG PerfQueryCounterInfo(
  [in]            HANDLE                   hQuery,
  [out, optional] PPERF_COUNTER_IDENTIFIER pCounters,
                  DWORD                    cbCounters,
  [out]           LPDWORD                  pcbCountersActual
);

매개 변수

[in] hQuery

카운터 사양을 가져올 쿼리에 대한 핸들

[out, optional] pCounters

cbCounters 매개 변수가 지정하는 데이터의 양을 바이트 단위로 저장할 수 있을 만큼 큰 버퍼에 대한 포인터입니다. cbCounters가 0인 경우 NULL일 수 있습니다.

cbCounters

pCounters 버퍼의 크기(바이트)입니다.

[out] pcbCountersActual

카운터 사양을 가져오는 데 실제로 필요한 버퍼의 크기입니다. 의미는 함수의 값에 따라 달라집니다.

반환.

함수 반환 값	pcbCountersActual의 의미
ERROR_SUCCESS	의 수 pCounters가 지정한 버퍼에 저장된 함수의 카운터 사양에 대한 정보의 바이트입니다.
ERROR_NOT_ENOUGH_MEMORY	The 카운터 사양에 대한 정보를 저장하는 데 필요한 버퍼의 크기(바이트)입니다. 버퍼를 필수로 확대 크기를 조정하고 함수를 다시 호출합니다.
기타	값이 정의되어 있지 않으므로 사용하면 안 됩니다.

반환 값

반환 코드	설명
ERROR_SUCCESS	함수는 pCounters 가 지정한 버퍼에 카운터 사양에 대한 모든 정보를 성공적으로 저장했습니다. pcbCountersActual이 가리키는 값은 버퍼에 실제로 저장된 정보의 양을 바이트 단위로 나타냅니다.
ERROR_NOT_ENOUGH_MEMORY	pCounters가 지정한 버퍼가 카운터 사양에 대한 모든 정보를 저장할 만큼 크지 않았습니다. pcbCountersActual이 가리키는 값은 모든 정보를 저장하는 데 필요한 버퍼의 크기를 나타냅니다. 버퍼를 필수로 확대 크기를 조정하고 함수를 다시 호출합니다.

 

다른 유형의 오류의 경우 반환 값은 시스템 오류 코드입니다.

설명

카운터 사양에 대한 정보는 pCounters 가 PERF_COUNTER_IDENTIFIER 블록 시퀀스로 지정하는 버퍼에 기록됩니다. 의 크기(바이트)입니다.

블록 시퀀스는 pcbCountersActual에 기록됩니다. 각 PERF_COUNTER_IDENTIFIER 블록은

필요에 따라 null 로 종료된 UTF-16LE이 뒤따르는 PERF_COUNTER_IDENTIFIER 구조체의

instance 이름 뒤에 안쪽 여백을 추가하여 의 크기를 지정합니다.

PERF_COUNTER_IDENTIFIER 블록은 8바이트의 배수입니다. PERF_COUNTER_IDENTIFIER 구조체, instance 이름 및 패딩을 포함한 각 블록의 크기는 8바이트의 배수인 PERF_COUNTER_IDENTIFIER 구조체의 Size 멤버에 의해 결정됩니다.

요구 사항

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

추가 정보

PERF_COUNTER_IDENTIFIER