次の方法で共有


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

CounterIndexRangeOverflowHandler、または 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 つのユニットとして割り当てて解放できます。 これを行うには、ドライバーは HalAllocateHardwareCountersHalFreeHardwareCounters を呼び出します

要件

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

こちらもご覧ください

PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE

PHYSICAL_COUNTER_RESOURCE_LIST