PerfQueryCounterData 함수(perflib.h)

  • 아티클

지정된 쿼리의 카운터 사양과 일치하는 성능 카운터의 값을 가져옵니다.

구문

ULONG PerfQueryCounterData(
  [in]            HANDLE            hQuery,
  [out, optional] PPERF_DATA_HEADER pCounterBlock,
                  DWORD             cbCounterBlock,
  [out]           LPDWORD           pcbCounterBlockActual
);

매개 변수

[in] hQuery

값을 가져올 성능 카운터의 카운터 사양에 대한 쿼리 핸들입니다.

[out, optional] pCounterBlock

cbCounterBlock 매개 변수가 지정하는 데이터의 양을 받을 수 있는 충분한 공간이 있는 버퍼에 대한 포인터(바이트)입니다. 이면 NULL일 수 있습니다.

cbCounterBlock 은 0입니다.

cbCounterBlock

pCounterBlock 매개 변수가 지정하는 버퍼의 크기(바이트)입니다.

[out] pcbCounterBlockActual

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

반환.

함수 반환 값 pcbCounterBlockActual의 의미
ERROR_SUCCESS 의 수

함수가 pCounterBlock이 지정한 버퍼에 저장된 성능 카운터 값의 바이트입니다.
ERROR_NOT_ENOUGH_MEMORY The

성능 카운터 값을 저장하는 데 필요한 버퍼의 크기(바이트)입니다. 버퍼를 필수로 확대

크기를 조정하고 함수를 다시 호출합니다.
기타 값이 정의되지 않았으며 사용하면 안 됩니다.

반환 값

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

크기를 조정하고 함수를 다시 호출합니다.
 

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

설명

성능 카운터 값에 대한 정보는 pCounterBlock 이 PERF_DATA_HEADER 블록으로 지정하는 버퍼에 기록되며, PERF_DATA_HEADER 구조와 PERF_COUNTER_HEADER 블록 시퀀스로 구성됩니다.

요구 사항

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

추가 정보

PERF_COUNTER_HEADER

PERF_DATA_HEADER