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 。

傳回值

無

備註

藉由呼叫 HalAllocateHardwareCounters ，並具有類型 為 PHYSICAL_COUNTER_RESOURCE_LIST 的結構，以註冊此回呼函式的實作。 在PHYSICAL_COUNTER_RESOURCE_LIST中，提供類型PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR的結構，指定 ResourceTypeEventBuffer 的PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE。

在 IRQL = PROFILE_LEVEL呼叫此回呼。 這表示它必須一律是記憶體駐留的。 回呼應該儘快傳回，且不應嘗試執行下列任何動作。

• 取得或釋放微調鎖定。

• 存取記憶體中未鎖定的分頁集區

• 呼叫可分頁的例程。

回呼不需要處理清除任何溢位緩存器，因為它將由 HAL 處理。

規格需求