estructura PCW_COUNTER_DESCRIPTOR (wdm.h)
La estructura PCW_COUNTER_DESCRIPTOR 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 acceder directamente a esta estructura 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. Esto debe coincidir con el valor proporcionado en el campo id de un contador de elemento del 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 PcwAddInstance, el bloque de datos descrito por PcwData[PcwCounterDescriptor->StructIndex] se usará como origen de datos para el contador con id. PcwCounterDescriptor->Id.
Offset
Valor numérico que especifica un desplazamiento (en bytes) en relación con el bloque de datos indicado por el campo StructIndex. En llamadas posteriores a PcwCreateInstance o PcwAddInstance, la dirección PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset se usará como 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 id. PcwCounterDescriptor->Id. El campo Size debe establecerse en 4 (para un valor de contador de UINT32) o 8 (para un valor de contador de UINT64).
Observaciones
La mayoría de los desarrolladores no necesitan usar esta estructura directamente. La herramienta CTRPP genera código de registro que inicializa PCW_COUNTER_DESCRIPTOR estructuras basadas en el contenido del manifiesto del proveedor.
Se proporciona una matriz de estructuras de PCW_COUNTER_DESCRIPTOR durante el registro del conjunto de contadores (a través de la estructura PCW_REGISTRATION_INFORMATION pasada 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 matriz de PCW_DATA.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows 7 y versiones posteriores de Windows. |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h) |
Consulte también
de estructura de _PCW_REGISTRATION_INFORMATION