Compartir a través de


PPHYSICAL_COUNTER_EVENT_BUFFER_OVERFLOW_HANDLER función de devolución de llamada (ntddk.h)

El controlador cliente implementa el PPHYSICAL_COUNTER_OVERFLOW_HANDLER para controlar los desbordamientos del búfer de eventos de los recursos de contadores adquiridos a través de la rutina HalAllocateHardwareCounters.

Sintaxis

PPHYSICAL_COUNTER_EVENT_BUFFER_OVERFLOW_HANDLER PphysicalCounterEventBufferOverflowHandler;

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

Parámetros

EventBuffer

Proporciona un puntero al búfer de eventos que contiene las entradas del evento.

EntrySize

Proporciona el tamaño de una entrada de evento individual.

NumberOfEntries

Proporciona el número de entradas disponibles.

OwningHandle

Proporciona el HANDLE correspondiente al conjunto de recursos al que pertenece el búfer de eventos.

Valor devuelto

Ninguno

Observaciones

Registre la implementación de esta función de devolución de llamada llamando a HalAllocateHardwareCounters con una estructura de tipo PHYSICAL_COUNTER_RESOURCE_LIST. En el PHYSICAL_COUNTER_RESOURCE_LIST, proporcione una estructura de tipo PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR que especifique un PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE de ResourceTypeEventBuffer.

Esta devolución de llamada se llama en IRQL = PROFILE_LEVEL. Esto significa que siempre debe ser residente en memoria. La devolución de llamada debe devolverse lo antes posible y no debe intentar realizar ninguna de las acciones siguientes.

  • Adquiera o libere bloqueos de número.

  • Acceso al grupo paginado que no está bloqueado en la memoria

  • Llame a una rutina paginable.

La devolución de llamada no necesita controlar el borrado de los registros de desbordamiento, ya que el HAL lo controlará.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 10, versión 1903
encabezado de ntddk.h
irQL PROFILE_LEVEL