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를 호출합니다.

요구 사항

추가 정보

PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE

PHYSICAL_COUNTER_RESOURCE_LIST