PDH_COUNTER_INFO_W構造体 (pdh.h)

  • [アーティクル]

PDH_COUNTER_INFO構造体には、カウンターのプロパティを記述する情報が含まれています。 この情報には、カウンター パスも含まれます。

構文

typedef struct _PDH_COUNTER_INFO_W {
  DWORD     dwLength;
  DWORD     dwType;
  DWORD     CVersion;
  DWORD     CStatus;
  LONG      lScale;
  LONG      lDefaultScale;
  DWORD_PTR dwUserData;
  DWORD_PTR dwQueryUserData;
  LPWSTR    szFullPath;
  union {
    PDH_DATA_ITEM_PATH_ELEMENTS_W DataItemPath;
    PDH_COUNTER_PATH_ELEMENTS_W   CounterPath;
    struct {
      LPWSTR szMachineName;
      LPWSTR szObjectName;
      LPWSTR szInstanceName;
      LPWSTR szParentInstance;
      DWORD  dwInstanceIndex;
      LPWSTR szCounterName;
    };
  };
  LPWSTR    szExplainText;
  DWORD     DataBuffer[1];
} PDH_COUNTER_INFO_W, *PPDH_COUNTER_INFO_W;

メンバー

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

PDH_COUNTER_PATH_ELEMENTS構造体。

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

こちらもご覧ください

PDH_COUNTER_PATH_ELEMENTS

PDH_DATA_ITEM_PATH_ELEMENTS

PdhGetCounterInfo