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 （include Ntddk.h， Ntifs.h） |