PERF_COUNTER_HEADER 구조체(perflib.h)

  • 아티클

구조체를 포함하는 PERF_COUNTER_HEADER 블록에 대한 정보를 포함합니다. PERF_COUNTER_HEADER 블록은 성능 카운터 쿼리에 대한 오류 정보와 데이터를 제공하며 PERF_COUNTER_HEADER 구조와 추가 성능 카운터 데이터로 구성됩니다.

구문

typedef struct _PERF_COUNTER_HEADER {
  ULONG               dwStatus;
  PerfCounterDataType dwType;
  ULONG               dwSize;
  ULONG               Reserved;
} PERF_COUNTER_HEADER, *PPERF_COUNTER_HEADER;

멤버

dwStatus

성능을 쿼리하는 작업이 성공했는지 실패했는지 여부를 나타내는 오류 코드입니다.

dwType

PERF_COUNTER_HEADER 블록에서 제공하는 성능 카운터 정보의 유형입니다.

값 의미
PERF_ERROR_RETURN
 성능 카운터 쿼리의 결과인 오류입니다. 성능 라이브러리는 공급자로부터 유효한 카운터 데이터를 다시 가져올 수 없습니다. PERF_COUNTER_HEADER 구조를 따르는 추가 데이터는 없습니다. 구조체의 dwStatus 멤버에는 오류 코드가 포함됩니다.
PERF_SINGLE_COUNTER
 단일 카운터, 단일 instance 쿼리의 결과(예: "\Processor(_Total)\% Processor Time"입니다. 추가 데이터는 PERF_COUNTER_DATA 블록으로 구성됩니다.
PERF_MULTIPLE_COUNTERS
 다중 카운터 단일 instance 쿼리의 결과입니다(예: "\Processor(_Total)\*"). 추가 데이터는 PERF_MULTI_COUNTERS 블록과 PERF_COUNTER_DATA 블록으로 구성됩니다.
PERF_MULTIPLE_INSTANCES
 단일 카운터 다중 instance 쿼리의 결과입니다(예: "\Processor(*)\% Processor Time"). 추가 데이터는 PERF_MULTI_INSTANCES 블록으로 구성됩니다.
PERF_COUNTERSET
 다중 카운터 다중 instance 쿼리의 결과입니다(예: "\Processor(*)\*"). 추가 데이터는 PERF_MULTI_COUNTERS 블록과 PERF_MULTI_INSTANCES 블록으로 구성됩니다.

dwSize

PERF_COUNTER_HEADER 구조체의 크기 및 추가 데이터의 크기와 같은 PERF_COUNTER_HEADER 블록의 총 크기입니다.

Reserved

예약되어 있습니다.

설명

PerfQueryCounterData 함수는 PERF_COUNTER_HEADER 블록 시퀀스를 포함하는 PERF_DATA_HEADER 블록을 반환합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 10 버전 1607 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2016 [데스크톱 앱만 해당]
머리글 perflib.h

추가 정보

PERF_COUNTER_DATA

PERF_MULTI_COUNTERS

PERF_MULTI_INSTANCES

PerfCounterDataType