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 구조체의 배열로 인덱스를 지정하는 숫자 값입니다.
PcwCreateInstance 또는 PcwAddInstance대한 후속 호출에서 PcwData[PcwCounterDescriptor->StructIndex] 설명한 데이터 블록은 ID가 PcwCounterDescriptor->Id카운터의 데이터 원본으로 사용됩니다.
Offset
StructIndex 필드에 표시된 데이터 블록을 기준으로 오프셋(바이트)을 지정하는 숫자 값입니다.
PcwCreateInstance 또는 PcwAddInstance대한 후속 호출에서 주소 PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset ID가 PcwCounterDescriptor->Id카운터 값의 시작으로 사용됩니다.
Size
ID가 PcwCounterDescriptor->Id카운터 값의 크기를 바이트 단위로 지정하는 숫자 값입니다.
Size 필드는 4(UINT32 카운터 값의 경우) 또는 8(UINT64 카운터 값의 경우)으로 설정해야 합니다.
발언
대부분의 개발자는 이 구조를 직접 사용할 필요가 없습니다.
CTRPP 도구는 공급자 매니페스트의 내용을 기반으로 PCW_COUNTER_DESCRIPTOR 구조를 초기화하는 등록 코드를 생성합니다.
PcwRegister전달된 PCW_REGISTRATION_INFORMATION 구조를 통해 카운터셋 등록 중에 PCW_COUNTER_DESCRIPTOR 구조의 배열이 제공됩니다. 배열의 정보가 기록되며 PcwCreateInstance 또는 PcwAddInstancePCW_DATA 배열에 설명된 데이터 블록에서 카운터 값을 추출하는 데 사용됩니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 이상 버전의 Windows에서 사용할 수 있습니다. |
| 헤더 | wdm.h(Wdm.h, Ntddk.h 포함) |