PPHYSICAL_COUNTER_EVENT_BUFFER_OVERFLOW_HANDLER回调函数 (ntddk.h)

PPHYSICAL_COUNTER_OVERFLOW_HANDLER由客户端驱动程序实现,用于处理通过 HalAllocateHardwareCounters 例程获取的计数器资源的事件缓冲区溢出。

语法

PPHYSICAL_COUNTER_EVENT_BUFFER_OVERFLOW_HANDLER PphysicalCounterEventBufferOverflowHandler;

void PphysicalCounterEventBufferOverflowHandler(
  PVOID EventBuffer,
  SIZE_T EntrySize,
  SIZE_T NumberOfEntries,
  HANDLE OwningHandle
)
{...}

参数

EventBuffer

提供指向包含事件条目的事件缓冲区的指针。

EntrySize

提供单个事件条目的大小。

NumberOfEntries

提供可用的条目数。

OwningHandle

提供与事件缓冲区所属的资源集对应的 HANDLE

返回值

没有

言论

通过调用 HalAllocateHardwareCountersPHYSICAL_COUNTER_RESOURCE_LIST类型的结构来注册此回调函数的实现。 在 PHYSICAL_COUNTER_RESOURCE_LIST中,提供一个类型 PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR 的结构,该结构指定 resourceTypeEventBuffer PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE

此回调在 IRQL = PROFILE_LEVEL调用。 这意味着它必须始终是内存驻留的。 回调应尽快返回,不应尝试执行以下任一作。

  • 获取或释放旋转锁。

  • 未锁定在内存中的访问分页池

  • 调用可分页例程。

回调不需要处理清除任何溢出寄存器,因为它将由 HAL 处理。

要求

要求 价值
最低支持的客户端 Windows 10 版本 1903
标头 ntddk.h
IRQL PROFILE_LEVEL