次の方法で共有

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 構造体は、単一のハードウェア カウンター、連続したカウンターのブロック、カウンター オーバーフロー割り込み、またはイベント バッファー構成のカウンター リソースを記述します。 この構造体の Type メンバーは、構造体によって記述されるカウンター リソースの種類を示します。

カウンター リソースのセットを指定するために、カーネル モード クライアントは PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR 構造体の配列を提供できます。 PHYSICAL_COUNTER_RESOURCE_LIST 構造体は、配列のヘッダーとして機能します。 クライアントは、配列によって 1 つの単位として記述されたカウンター リソースのセットを割り当てて解放できます。 これを行うには、ドライバーは HalAllocateHardwareCountersを呼び出し、HalFreeHardwareCountersをします。

必要条件

要件 価値
サポートされる最小クライアント Windows 7 以降のバージョンの Windows でサポートされています。
ヘッダー ntddk.h (Ntddk.h、Ntifs.h を含む)

関連項目

PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE

PHYSICAL_COUNTER_RESOURCE_LIST