структура PCW_COUNTER_DESCRIPTOR (wdm.h)

Статья
02/07/2025

Структура 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элемента счетчика в манифесте набора счетчиков поставщика.

StructIndex

Числовое значение, указывающее индекс в массив PCW_DATA структур. В последующих вызовах PcwCreateInstance или PcwAddInstanceблок данных, описанный PcwData[PcwCounterDescriptor->StructIndex], будет использоваться в качестве источника данных для счетчика с идентификатором PcwCounterDescriptor->Id.

Offset

Числовое значение, указывающее смещение (в байтах) относительно блока данных, указанного полем StructIndex. В последующих вызовах PcwCreateInstance или PcwAddInstanceадрес PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset будет использоваться в качестве начала значения счетчика с идентификатором PcwCounterDescriptor->Id.

Size

Числовое значение, указывающее размер счетчика в байтах с идентификатором PcwCounterDescriptor->Id. Поле Size должно иметь значение 4 (для значения счетчика UINT32) или 8 (для значения счетчика UINT64).

Замечания

Большинству разработчиков не нужно напрямую использовать эту структуру. Средство CTRPP создает код регистрации, который инициализирует структуры PCW_COUNTER_DESCRIPTOR на основе содержимого манифеста поставщика.

Массив структур PCW_COUNTER_DESCRIPTOR предоставляется во время регистрации счетчиков (через структуру PCW_REGISTRATION_INFORMATION, переданную в PcwRegister). Данные из массива записываются и будут использоваться PcwCreateInstance или PcwAddInstance для извлечения значений счетчиков из блоков данных, описанных массивом PCW_DATA.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows 7 и более поздних версиях Windows.
заголовка	wdm.h (include Wdm.h, Ntddk.h)

См. также

_PCW_REGISTRATION_INFORMATION структура

_PCW_DATA структуры

CTRPP

счетчик сложного типа

Поделиться через