PDH_COUNTER_INFO_A 構造体 (pdh.h)
PDH_COUNTER_INFO構造体には、カウンターのプロパティを説明する情報が含まれています。 この情報には、カウンター パスも含まれます。
構文
typedef struct _PDH_COUNTER_INFO_A {
DWORD dwLength;
DWORD dwType;
DWORD CVersion;
DWORD CStatus;
LONG lScale;
LONG lDefaultScale;
DWORD_PTR dwUserData;
DWORD_PTR dwQueryUserData;
LPSTR szFullPath;
union {
PDH_DATA_ITEM_PATH_ELEMENTS_A DataItemPath;
PDH_COUNTER_PATH_ELEMENTS_A CounterPath;
struct {
LPSTR szMachineName;
LPSTR szObjectName;
LPSTR szInstanceName;
LPSTR szParentInstance;
DWORD dwInstanceIndex;
LPSTR szCounterName;
};
};
LPSTR szExplainText;
DWORD DataBuffer[1];
} PDH_COUNTER_INFO_A, *PPDH_COUNTER_INFO_A;
メンバー
dwLength
追加された文字列を含む構造体のサイズ (バイト単位)。
dwType
カウンターの種類。 カウンターの種類の一覧については、 Windows Server 2003 展開キットのカウンターの種類に関するセクションを参照してください。 カウンター型の定数は Winperf.h で定義されています。
CVersion
カウンター のバージョン情報。 使用されていません。
CStatus
カウンター値が有効かどうかを示すカウンターの状態。 使用可能な値の一覧については、「 PDH インターフェイスの戻り値の確認」を参照してください。
lScale
カウンターの表示可能な値を計算するときに使用する倍率。 倍率は 10 の累乗です。 このパラメーターの有効な範囲は PDH_MIN_SCALE (–7) です (戻り値は実際の値の時間 10 – ⁷) からPDH_MAX_SCALE (+7) です (戻り値は実際の値の時間 10⁺⁷)。 値 0 を指定すると、スケールが 1 に設定され、実際の値が返されます
lDefaultScale
カウンターのプロバイダーが提案する既定のスケール ファクター。
dwUserData
PdhAddCounter を呼び出すときに dwUserData パラメーターで渡される値。
dwQueryUserData
PdhOpenQuery を呼び出すときに dwUserData パラメーターで渡される値。
szFullPath
完全なカウンター パスを指定する Null で終わる文字列。 文字列は、メモリ内のこの構造体に従います。
DataItemPath
PDH_DATA_ITEM_PATH_ELEMENTS構造体。 使用されていません。
CounterPath
szMachineName
カウンター パスで指定されたコンピューターの名前を含む Null で終わる文字列。 パスでコンピューターが指定されていない場合は NULL です。 文字列は、メモリ内のこの構造体に従います。
szObjectName
カウンター パスで指定されたパフォーマンス オブジェクトの名前を含む Null で終わる文字列。 文字列は、メモリ内のこの構造体に従います。
szInstanceName
カウンター パスで指定されたオブジェクト インスタンスの名前を含む Null で終わる文字列。 パスでインスタンスが指定されていない場合は NULL です。 文字列は、メモリ内のこの構造体に従います。
szParentInstance
カウンター パスで指定された親インスタンスの名前を含む Null で終わる文字列。 パスで親インスタンスが指定されていない場合は NULL です。 文字列は、メモリ内のこの構造体に従います。
dwInstanceIndex
カウンター パスで指定されたインスタンス インデックス。 パスでインスタンス インデックスが指定されていない場合は 0 です。
szCounterName
カウンター名を含む Null で終わる文字列。 文字列は、メモリ内のこの構造体に従います。
szExplainText
カウンターを説明するヘルプ テキスト。 ソースがログ ファイルの場合は NULL です 。
DataBuffer[1]
構造体に追加される文字列データの先頭。
注釈
この構造体にメモリを割り当てるときは、この構造体の末尾に追加されるメンバー文字列 ( szCounterName など) に十分なメモリを割り当てます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| Header | pdh.h |