Edit

PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION structure (ntddk.h)

  • Article

The PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION structure describes the configuration for event buffers on the platform.

Syntax

typedef struct _PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION {
  PPHYSICAL_COUNTER_EVENT_BUFFER_OVERFLOW_HANDLER OverflowHandler;
  ULONG                                           CustomEventBufferEntrySize;
  ULONG                                           EventThreshold;
} PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION, *PPHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION;

Members

OverflowHandler

A pointer to the driver-supplied *PPHYSICAL_COUNTER_EVENT_BUFFER_OVERFLOW_HANDLER routine that will be called when the event buffer entries reach a threshold in the event buffer.

CustomEventBufferEntrySize

The size of the event buffer entries, for custom event buffer sizes. Set to zero.

EventThreshold

The number of events to be recorded before the OverflowHandler callback routine is invoked. This value is used as a maximum threshold. The actual number of events will depend on the number of actors using event buffer profiling.

Remarks

Most processors have performance monitor units that contain a number of hardware counters for measuring various aspects of system performance. The PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION structure is used within the PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR structure to describe the configuration for event buffer resources.

Requirements

Requirement Value
Header ntddk.h

See also

PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE

PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR