次の方法で共有

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 を指定する数値。 これは、プロバイダーのカウンターセット マニフェスト内の カウンター 要素の id フィールドに指定された値と一致する必要があります。

StructIndex

PCW_DATA 構造体の配列へのインデックスを指定する数値。 PcwCreateInstance または PcwAddInstanceの後続の呼び出しでは、PcwData[PcwCounterDescriptor->StructIndex] によって記述されたデータ ブロックが、ID PcwCounterDescriptor->Idを持つカウンターのデータ ソースとして使用されます。

Offset

StructIndex フィールドによって示されるデータ ブロックに対する相対オフセット (バイト単位) を指定する数値。 PcwCreateInstance または PcwAddInstanceの後続の呼び出しでは、アドレス PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset が ID PcwCounterDescriptor->Idを持つカウンターの値の先頭として使用されます。

Size

ID PcwCounterDescriptor->Idを持つカウンターの値のサイズをバイト単位で指定する数値。 Size フィールドは、4 (UINT32 カウンター値の場合) または 8 (UINT64 カウンター値の場合) に設定する必要があります。

備考

ほとんどの開発者は、この構造を直接使用する必要はありません。 CTRPP ツールは、プロバイダー マニフェストの内容に基づいて PCW_COUNTER_DESCRIPTOR 構造体を初期化する登録コードを生成します。

PCW_COUNTER_DESCRIPTOR 構造体の配列は、(PcwRegisterに渡された PCW_REGISTRATION_INFORMATION 構造体を介して) カウンターセット登録中に提供されます。 配列からの情報が記録され、PcwCreateInstance または PcwAddInstance によって使用され、PCW_DATA 配列によって記述されたデータ ブロックからカウンター値が抽出されます。

必要条件

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

関連項目

_PCW_REGISTRATION_INFORMATION 構造体の

_PCW_DATA 構造体の

CTRPP

カウンター複合型