피드백

PCW_COUNTER_DESCRIPTOR 구조체(wdm.h)

  • 아티클
  • 읽는 데 2분 걸림

이 PCW_COUNTER_DESCRIPTOR 구조는 카운터 집합 등록 중에 카운터 값에 대한 정보를 제공하는 데 사용됩니다. 대부분의 개발자는 CTRPP 도구에서 생성된 카운터셋 등록 코드에 의해 자동으로 관리되므로 이 구조에 직접 액세스할 필요가 없습니다.

구문

typedef struct _PCW_COUNTER_DESCRIPTOR {
  USHORT Id;
  USHORT StructIndex;
  USHORT Offset;
  USHORT Size;
} PCW_COUNTER_DESCRIPTOR, *PPCW_COUNTER_DESCRIPTOR;

구성원

Id

이 구조에서 설명하는 카운터의 ID를 지정하는 숫자 값입니다. 공급자의 카운터 세트 매니페스트에서 id 카운터 요소의 필드에 제공된 값과 일치해야 합니다.

StructIndex

PCW_DATA 구조체의 배열로 인덱스를 지정하는 숫자 값입니다. 후속 호출 PcwCreateInstance 에서 설명된 PcwData[PcwCounterDescriptor->StructIndex] 데이터 블록은 IDPcwCounterDescriptor->Id가 있는 카운터의 데이터 PcwAddInstance원본으로 사용됩니다.

Offset

필드가 나타내는 StructIndex 데이터 블록을 기준으로 오프셋(바이트)을 지정하는 숫자 값입니다. 후속 호출 PcwCreateInstance 에서 PcwAddInstance주소 PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset 는 ID PcwCounterDescriptor->Id가 있는 카운터 값의 시작으로 사용됩니다.

Size

ID PcwCounterDescriptor->Id가 있는 카운터 값의 크기(바이트)를 지정하는 숫자 값입니다. Size 필드는 카운터 값의 경우 UINT32 4 또는 8(카운터 값의 경우)으로 UINT64 설정해야 합니다.

설명

대부분의 개발자는 이 구조를 직접 사용할 필요가 없습니다. 이 도구는 CTRPP 공급자 매니페스트의 내용을 기반으로 구조를 초기화하는 PCW_COUNTER_DESCRIPTOR 등록 코드를 생성합니다.

구조체 배열 PCW_COUNTER_DESCRIPTOR 은 카운터셋 등록 중에(전달된 PcwRegisterPCW_REGISTRATION_INFORMATION 구조를 통해) 제공됩니다. 배열의 정보가 기록되며 배열에서 설명하는 PCW_DATA 데이터 블록에서 카운터 값을 추출하거나 PcwAddInstance 사용하는 데 사용됩니다PcwCreateInstance.

요구 사항

   
지원되는 최소 클라이언트 Windows 7 이상 버전의 Windows 사용할 수 있습니다.
헤더 wdm.h(Wdm.h, Ntddk.h 포함)

참고 항목

_PCW_REGISTRATION_INFORMATION 구조체

_PCW_DATA 구조체

CTRPP

카운터 복합 형식