PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR 구조체(ntddk.h)
PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR 구조는 플랫폼에서 사용할 수 있는 카운터 리소스를 설명합니다.
구문
typedef struct _PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR {
PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE Type;
ULONG Flags;
union {
ULONG CounterIndex;
struct {
ULONG Begin;
ULONG End;
} Range;
PPHYSICAL_COUNTER_OVERFLOW_HANDLER OverflowHandler;
PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION EventBufferConfiguration;
ULONG IdentificationTag;
} u;
} PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR, *PPHYSICAL_COUNTER_RESOURCE_DESCRIPTOR;
멤버
Type
구조체에서 설명하는 카운터 리소스의 형식을 나타냅니다. 이 매개 변수를 다음 PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE 열거형 상수 중 하나로 설정합니다.
- ResourceTypeSingle
- ResourceTypeRange
- ResourceTypeOverflow
- ResourceTypeEventBuffer
Flags
현재 정의된 플래그가 없습니다. 이 멤버를 0으로 설정합니다.
u
CounterIndex, Range, OverflowHandler 또는 EventBufferConfiguration 값을 포함할 수 있는 공용 구조체입니다.
u.CounterIndex
물리적 카운터 인덱스입니다.
u.Range
카운터 인덱스의 범위입니다.
u.Range.Begin
연속 카운터 블록의 시작 카운터 인덱스입니다.
u.Range.End
연속 카운터 블록의 끝 카운터 인덱스입니다.
u.OverflowHandler
연결된 하드웨어 카운터(다른 PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR 지정됨)가 오버플로될 때 호출되는 드라이버 제공 PPHYSICAL_COUNTER_OVERFLOW_HANDLER 루틴에 대한 포인터입니다.
u.EventBufferConfiguration
이벤트 버퍼 기반 샘플링(예: Intel의 PEBS)에 대한 구성입니다. 구성 필드는 PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION 형식으로 정의됩니다.
u.IdentificationTag
설명
대부분의 프로세서에는 시스템 성능의 다양한 측면을 측정하기 위한 여러 하드웨어 카운터가 포함된 성능 모니터 단위가 있습니다. PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR 구조는 단일 하드웨어 카운터, 연속 카운터 블록, 카운터 오버플로 인터럽트 또는 이벤트 버퍼 구성일 수 있는 카운터 리소스를 설명합니다. 이 구조체의 Type 멤버는 구조체에서 설명하는 카운터 리소스의 형식을 나타냅니다.
카운터 리소스 집합을 지정하기 위해 커널 모드 클라이언트는 PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR 구조의 배열을 제공할 수 있습니다. PHYSICAL_COUNTER_RESOURCE_LIST 구조체는 배열의 헤더 역할을 합니다. 클라이언트는 배열에서 설명하는 카운터 리소스 집합을 단일 단위로 할당하고 해제할 수 있습니다. 이를 위해 드라이버는 HalAllocateHardwareCounters 및 HalFreeHardwareCounters를 호출합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 이상 버전의 Windows에서 지원됩니다. |
| 머리글 | ntddk.h(Ntddk.h, Ntifs.h 포함) |