PCW_COUNTER_DESCRIPTOR結構 (wdm.h)
結構 PCW_COUNTER_DESCRIPTOR
可用來在計數器集註冊期間提供計數器值的相關信息。 大部分開發人員不需要直接存取此結構,因為它會自動由 CTRPP 工具所產生的計數器集註冊程序代碼管理。
語法
typedef struct _PCW_COUNTER_DESCRIPTOR {
USHORT Id;
USHORT StructIndex;
USHORT Offset;
USHORT Size;
} PCW_COUNTER_DESCRIPTOR, *PPCW_COUNTER_DESCRIPTOR;
成員
Id
數值,指定這個 結構所描述之計數器的標識碼。 這應該符合提供者計數器集指令清單中id
計數器元素欄位中提供的值。
StructIndex
數值,指定 PCW_DATA 結構的陣列索引。 在後續對 PcwCreateInstance
或 PcwAddInstance
的呼叫中,所 PcwData[PcwCounterDescriptor->StructIndex]
描述的數據區塊將會當做標識碼 PcwCounterDescriptor->Id
為的計數器數據源使用。
Offset
數值,指定相對於 欄位所指示 StructIndex
之數據區塊的位移 (,以位元組為單位) 。 在或PcwAddInstance
的後續呼叫PcwCreateInstance
中,位址PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset
將會當做標識符PcwCounterDescriptor->Id
為 之計數器值的開頭。
Size
數值,指定標識子 PcwCounterDescriptor->Id
為 之計數器值的大小,以位元組為單位。 計數器 Size
值) 的字段應設定為 UINT32
4 (,或計數器值) 的 UINT64
8 個 (。
備註
大部分的開發人員不需要直接使用此結構。 此工具 CTRPP
會產生註冊程序代碼,以根據提供者指令清單的內容初始化 PCW_COUNTER_DESCRIPTOR
結構。
透過傳遞至 PcwRegister
) 的 PCW_REGISTRATION_INFORMATION 結構,在計數器集 (註冊期間會提供 結構的陣列PCW_COUNTER_DESCRIPTOR
。 陣列中的資訊會記錄下來,並由 或 PcwAddInstance
用來PcwCreateInstance
從陣列所PCW_DATA
描述的數據區塊擷取計數器值。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Windows 7 和更新版本的 Windows。 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h) |