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⁺⁷) 。 值為零會將小數字數設定為一，以便傳回實際值

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。

規格需求

另請參閱

PDH_COUNTER_PATH_ELEMENTS

PDH_DATA_ITEM_PATH_ELEMENTS

PdhGetCounterInfo