PCW_COUNTER_DESCRIPTOR 구조체(wdm.h)

  • 아티클

구조체 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 구조체의 배열로 지정하는 숫자 값입니다. 또는 PcwAddInstance에 PcwCreateInstance 대한 후속 호출에서 에서 설명하는 PcwData[PcwCounterDescriptor->StructIndex] 데이터 블록은 IDPcwCounterDescriptor->Id가 인 카운터의 데이터 원본으로 사용됩니다.

Offset

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

Size

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

설명

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

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 및 이후 버전의 Windows에서 사용할 수 있습니다.
머리글 wdm.h(Wdm.h, Ntddk.h 포함)

추가 정보

_PCW_REGISTRATION_INFORMATION 구조체

_PCW_DATA 구조체

CTRPP

카운터 복합 형식