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
フラグは現在定義されていません。 このメンバーを 0 に設定します。
u
CounterIndex、Range、OverflowHandler、または EventBufferConfiguration の値を含めることができる共用体。
u.CounterIndex
物理カウンター インデックス。
u.Range
カウンター インデックスの範囲。
u.Range.Begin
連続したカウンターのブロックの開始カウンター インデックス。
u.Range.End
連続したカウンターのブロックの終了カウンター インデックス。
u.OverflowHandler
関連付けられたハードウェア カウンター (別の PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR で指定) がオーバーフローしたときに呼び出される、ドライバー提供 のPPHYSICAL_COUNTER_OVERFLOW_HANDLER ルーチンへのポインター。
u.EventBufferConfiguration
イベント バッファー ベースのサンプリングの構成 (Intel の PEBS など)。 構成フィールドは、 PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION 型によって定義されます。
u.IdentificationTag
注釈
ほとんどのプロセッサには、システム パフォーマンスのさまざまな側面を測定するためのハードウェア カウンターが多数含まれているパフォーマンス モニター ユニットがあります。 PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR構造体は、1 つのハードウェア カウンター、連続したカウンターのブロック、カウンター オーバーフロー割り込み、またはイベント バッファーの構成であるカウンター リソースを記述します。 この構造体の Type メンバーは、構造体によって記述されるカウンター リソースの種類を示します。
カウンター リソースのセットを指定するために、カーネル モード クライアントは 、PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR 構造体の配列を提供できます。 PHYSICAL_COUNTER_RESOURCE_LIST構造体は、配列のヘッダーとして機能します。 クライアントは、配列によって記述されたカウンター リソースのセットを 1 つのユニットとして割り当てて解放できます。 これを行うには、ドライバーは HalAllocateHardwareCounters と HalFreeHardwareCounters を呼び出します
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 7 以降のバージョンの Windows でサポートされています。 |
Header | ntddk.h (Ntddk.h、Ntifs.h を含む) |