estructura PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR (ntddk.h)
La estructura PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR describe los recursos de contador disponibles en la plataforma.
Sintaxis
typedef struct _PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR {
PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE Type;
ULONG Flags;
union {
ULONG CounterIndex;
struct {
ULONG Begin;
ULONG End;
} Range;
PPHYSICAL_COUNTER_OVERFLOW_HANDLER OverflowHandler;
PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION EventBufferConfiguration;
ULONG IdentificationTag;
} u;
} PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR, *PPHYSICAL_COUNTER_RESOURCE_DESCRIPTOR;
Miembros
Type
Indica el tipo de recurso de contador descrito por la estructura . Establezca este parámetro en una de las siguientes constantes de enumeración PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE :
- ResourceTypeSingle
- ResourceTypeRange
- ResourceTypeOverflow
- ResourceTypeEventBuffer
Flags
Actualmente no hay marcas definidas. Establezca este miembro en cero.
u
Unión que puede contener un valor CounterIndex, Range, OverflowHandler o EventBufferConfiguration .
u.CounterIndex
Índice de contador físico.
u.Range
Intervalo de índices de contador.
u.Range.Begin
Índice de contador inicial de un bloque de contadores contiguos.
u.Range.End
Índice de contador final de un bloque de contadores contiguos.
u.OverflowHandler
Puntero a la rutina de PPHYSICAL_COUNTER_OVERFLOW_HANDLER proporcionada por el controlador que se llamará cuando se desborde un contador de hardware asociado (especificado por otro PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR).
u.EventBufferConfiguration
Configuración del muestreo basado en el búfer de eventos (por ejemplo, PEBS de Intel). Los campos de configuración se definen mediante el tipo PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION .
u.IdentificationTag
Comentarios
La mayoría de los procesadores tienen unidades de monitor de rendimiento que contienen una serie de contadores de hardware para medir varios aspectos del rendimiento del sistema. La estructura PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR describe un recurso de contador, que puede ser un único contador de hardware, un bloque de contadores contiguos, una interrupción de desbordamiento de contadores o una configuración de búfer de eventos. El miembro Type de esta estructura indica qué tipo de recurso de contador se describe mediante la estructura.
Para especificar un conjunto de recursos de contador, un cliente en modo kernel puede proporcionar una matriz de estructuras de PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR . Una estructura de PHYSICAL_COUNTER_RESOURCE_LIST actúa como encabezado para la matriz. El cliente puede asignar y liberar el conjunto de recursos de contador descritos por la matriz como una sola unidad. Para ello, el controlador llama a HalAllocateHardwareCounters y HalFreeHardwareCounters.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con Windows 7 y versiones posteriores de Windows. |
| Encabezado | ntddk.h (incluya Ntddk.h, Ntifs.h) |