estructura PCW_COUNTER_DESCRIPTOR (wdm.h)
La PCW_COUNTER_DESCRIPTOR estructura se usa para proporcionar información sobre un valor de contador durante el registro del conjunto de contadores. La mayoría de los desarrolladores no necesitan tener acceso a esta estructura directamente porque se administra automáticamente mediante el código de registro del conjunto de contadores generado por la herramienta CTRPP .
Sintaxis
typedef struct _PCW_COUNTER_DESCRIPTOR {
USHORT Id;
USHORT StructIndex;
USHORT Offset;
USHORT Size;
} PCW_COUNTER_DESCRIPTOR, *PPCW_COUNTER_DESCRIPTOR;
Miembros
Id
Valor numérico que especifica el identificador del contador descrito por esta estructura. Debe coincidir con el valor proporcionado en el id campo de un elemento counter en el manifiesto del conjunto de contadores del proveedor.
StructIndex
Valor numérico que especifica un índice en una matriz de estructuras de PCW_DATA . En llamadas posteriores a PcwCreateInstance o , el bloque de datos descrito por PcwData[PcwCounterDescriptor->StructIndex] se usará como origen de datos para el contador con el identificador PcwCounterDescriptor->IdPcwAddInstance.
Offset
Valor numérico que especifica un desplazamiento (en bytes) relativo al bloque de datos indicado por el StructIndex campo. En llamadas posteriores a PcwCreateInstance o PcwAddInstance, la dirección PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset se usará como el inicio del valor del contador con el identificador PcwCounterDescriptor->Id.
Size
Valor numérico que especifica el tamaño, en bytes, del valor del contador con el identificador PcwCounterDescriptor->Id. El Size campo debe establecerse en 4 (para un UINT32 valor de contador) o 8 (para un UINT64 valor de contador).
Comentarios
La mayoría de los desarrolladores no necesitan usar esta estructura directamente. La CTRPP herramienta genera código de registro que inicializa PCW_COUNTER_DESCRIPTOR estructuras basadas en el contenido del manifiesto del proveedor.
Se proporciona una matriz de PCW_COUNTER_DESCRIPTOR estructuras durante el registro del conjunto de contadores (a través de la estructura de PCW_REGISTRATION_INFORMATION que se pasa a PcwRegister). La información de la matriz se registra y la usará PcwCreateInstance o PcwAddInstance para extraer valores de contador de los bloques de datos descritos por una PCW_DATA matriz.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 7 y versiones posteriores de Windows. |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h) |