共用方式為

PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR 結構 (ntddk.h)

  • 發行項

PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR 結構描述平臺上可用的計數器資源。

語法

typedef struct _PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR {
  PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE Type;
  ULONG                                     Flags;
  union {
    ULONG                                       CounterIndex;
    struct {
      ULONG Begin;
      ULONG End;
    } Range;
    PPHYSICAL_COUNTER_OVERFLOW_HANDLER          OverflowHandler;
    PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION EventBufferConfiguration;
    ULONG                                       IdentificationTag;
  } u;
} PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR, *PPHYSICAL_COUNTER_RESOURCE_DESCRIPTOR;

成員

Type

指出結構所描述的計數器資源類型。 將此參數設定為下列其中一個 PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE 列舉常數：

  • ResourceTypeSingle
  • ResourceTypeRange
  • ResourceTypeOverflow
  • ResourceTypeEventBuffer

Flags

目前未定義旗標。 將此成員設定為零。

u

可以包含 CounterIndex、 Range、 OverflowHandler 或 EventBufferConfiguration 值的聯集。

u.CounterIndex

實體計數器索引。

u.Range

計數器索引的範圍。

u.Range.Begin

連續計數器區塊的起始計數器索引。

u.Range.End

連續計數器區塊的結束計數器索引。

u.OverflowHandler

驅動程式提供的 PPHYSICAL_COUNTER_OVERFLOW_HANDLER 例程指標，當另一個 PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR) 溢位所指定的相關聯硬體計數器 (時呼叫。

u.EventBufferConfiguration

事件緩衝區型取樣的設定 (，例如 Intel 的 PEBS) 。 組態欄位是由 PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION 類型所定義。

u.IdentificationTag

備註

大部分處理器都有性能監視器單位，其中包含許多硬體計數器，可用來測量系統效能的各種層面。 PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR 結構描述計數器資源，可以是單一硬體計數器、連續計數器區塊、計數器溢位中斷或事件緩衝區組態。 這個結構的 Type 成員會指出結構所描述的計數器資源類型。

若要指定一組計數器資源，核心模式用戶端可以提供 PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR 結構的陣列。 PHYSICAL_COUNTER_RESOURCE_LIST 結構可作為陣列的標頭。 用戶端可以配置並釋放數位所描述的計數器資源集作為單一單位。 若要這樣做，驅動程式會呼叫 HalAllocateHardwareCounters 和 HalFreeHardwareCounters

規格需求

需求 值
最低支援的用戶端 Windows 7 和更新版本的 Windows 支援。
標頭 ntddk.h (包含 Ntddk.h、Ntifs.h)

另請參閱

PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE

PHYSICAL_COUNTER_RESOURCE_LIST