PERF_COUNTER_DEFINITION 구조체(winperf.h)
성능 카운터에 대해 설명합니다.
구문
typedef struct _PERF_COUNTER_DEFINITION {
DWORD ByteLength;
DWORD CounterNameTitleIndex;
#if ...
DWORD CounterNameTitle;
#else
LPWSTR CounterNameTitle;
#endif
DWORD CounterHelpTitleIndex;
#if ...
DWORD CounterHelpTitle;
#else
LPWSTR CounterHelpTitle;
#endif
LONG DefaultScale;
DWORD DetailLevel;
DWORD CounterType;
DWORD CounterSize;
DWORD CounterOffset;
} PERF_COUNTER_DEFINITION, *PPERF_COUNTER_DEFINITION;
멤버
ByteLength
이 구조체의 크기(바이트)입니다.
CounterNameTitleIndex
타이틀 데이터베이스에 있는 카운터 이름의 인덱스입니다. 인덱스 를 사용하여 카운터의 이름을 검색하는 방법에 대한 자세한 내용은 카운터 이름 및 도움말 텍스트 검색을 참조하세요.
이 값을 설정하기 위해 공급자는 기호 파일에 정의된 카운터의 오프셋 값을 First Counter 레지스트리 값에 추가합니다. 자세한 내용은 레지스트리에 카운터 이름 및 설명 추가 및 OpenPerformanceData 함수 구현을 참조하세요.
카운터가 기본 카운터인 경우 이 값은 0이어야 합니다(CounterType 에는 PERF_COUNTER_BASE 플래그가 포함됨).
CounterNameTitle
예약되어 있습니다.
CounterHelpTitleIndex
타이틀 데이터베이스에 있는 카운터의 도움말 텍스트에 대한 인덱스입니다. 인덱스 를 사용하여 카운터의 도움말 텍스트를 검색하는 방법에 대한 자세한 내용은 카운터 이름 및 도움말 텍스트 검색을 참조하세요.
이 값을 설정하기 위해 공급자는 기호 파일에 정의된 카운터의 오프셋 값을 First Help 레지스트리 값에 추가합니다. 자세한 내용은 레지스트리에 카운터 이름 및 설명 추가 및 OpenPerformanceData 함수 구현을 참조하세요.
카운터가 기본 카운터인 경우 이 값은 0이어야 합니다(CounterType 에는 PERF_COUNTER_BASE 플래그가 포함됨).
CounterHelpTitle
예약되어 있습니다.
DefaultScale
카운터 값을 그래프로 표시할 때 사용할 배율 인수입니다. 유효한 값은 -7에서 7까지입니다(값은 0.0000001 - 100000000에 해당). 이 값이 0이면 배율 값은 1이고, 이 값이 1이면 배율 값은 10이고, 이 값이 –1이면 배율 값은 .10이고, 등등.
DetailLevel
카운터에 대한 세부 정보 수준입니다. 소비자는 이 값을 사용하여 표시 복잡성을 제어합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.
| 세부 정보 수준 | 의미 |
|---|---|
|
카운터 데이터는 모든 사용자에 대해 제공됩니다. |
|
카운터 데이터는 고급 사용자를 위해 제공됩니다. |
|
카운터 데이터는 전문 사용자를 위해 제공됩니다. |
|
카운터 데이터는 시스템 디자이너에 대해 제공됩니다. |
CounterType
카운터의 유형입니다. 미리 정의된 카운터 형식 목록은 Windows Server 2003 배포 키트의 카운터 형식 섹션을 참조하세요. 소비자는 카운터 형식을 사용하여 카운터 값을 계산하고 표시하는 방법을 결정합니다. 공급자는 선택한 카운터 유형을 미리 정의된 목록으로 제한해야 합니다.
CounterSize
카운터 크기(바이트)입니다.
현재는 카운터 값을 제공하는 데 DWORD(4바이트) 및 ULONGLONG(8바이트)만 사용됩니다.
CounterOffset
PERF_COUNTER_BLOCK 구조체의 시작부터 이 카운터의 첫 번째 바이트까지 오프셋됩니다. PERF_OBJECT_TYPE 블록 내의 PERF_COUNTER_BLOCK 구조체의 위치는 개체에 인스턴스가 포함되어 있는지여부에 따라 달라집니다. 자세한 내용은 성능 데이터 형식을 참조하세요.
여러 카운터는 동일한 원시 데이터를 사용하고 PERF_COUNTER_BLOCK 블록에서 동일한 오프셋을 가리킬 수 있습니다.
설명
PERF_OBJECT_TYPE 구조체에는 하나 이상의 카운터가 포함되어 있습니다. 이 구조체는 각 카운터를 정의하고 해당 값에 오프셋을 제공합니다. 이러한 구조체는 메모리의 PERF_OBJECT_TYPE 구조를 따릅니다. 자세한 내용은 성능 데이터 형식을 참조하세요.
공급자는 카운터를 쿼리할 때마다 동일한 순서로 카운터를 제공해야 합니다. 카운터가 계산에 기본 카운터를 사용하는 경우(카운터 형식에 PERF_COUNTER_FRACTION 플래그 포함) 카운터 목록에서 기본 카운터가 이 카운터를 따라야 합니다. 카운터 형식에 PERF_MULTI_COUNTER 플래그가 포함된 경우 두 번째 카운터 값은 PERF_COUNTER_BLOCK 블록에서 이 카운터의 값을 따라야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 머리글 | winperf.h(Windows.h 포함) |