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

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

StructIndex

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

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). Сведения из массива записываются и будут использоваться или PcwAddInstance для PcwCreateInstance извлечения значений счетчиков из блоков данных, описанных массивомPCW_DATA.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 7 и более поздних версиях Windows.
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h)

См. также раздел

структура _PCW_REGISTRATION_INFORMATION

структура _PCW_DATA

CTRPP

сложный тип counter