Compartir a través de

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

  • Artículo

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 identificador correspondiente al conjunto de recursos al que pertenece el búfer de eventos.

Valor devuelto

None

Observaciones

Registre la implementación de esta función de devolución de llamada mediante una llamada 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 siguientes acciones.

  • Adquirir o liberar bloqueos de giro.

  • 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 Value
Cliente mínimo compatible Windows 10, versión 1903
Encabezado ntddk.h
IRQL PROFILE_LEVEL