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
counter 要素の フィールドで指定された値と一致する必要があります。
StructIndex
構造体の配列へのインデックスを指定する数値 PCW_DATA 。 以降の または PcwAddInstance
のPcwCreateInstance
呼び出しでは、 によってPcwData[PcwCounterDescriptor->StructIndex]
記述されたデータ ブロックが、ID PcwCounterDescriptor->Id
を持つカウンターのデータ ソースとして使用されます。
Offset
フィールドによって示されるデータ ブロックに対する相対オフセット (バイト単位) を指定する StructIndex
数値。 または PcwAddInstance
のPcwCreateInstance
後続の呼び出しでは、アドレス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
配列は、(に渡された PCW_REGISTRATION_INFORMATION 構造体を介して) カウンターセット登録中に PcwRegister
提供されます。 配列からの情報が記録され、 または PcwAddInstance
によって使用され、配列によってPcwCreateInstance
記述されたデータ ブロックからカウンター値がPCW_DATA
抽出されます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 7 以降のバージョンの Windows で使用できます。 |
Header | wdm.h (Wdm.h、Ntddk.h を含む) |