winperf.h) (PERF_COUNTER_DEFINITION 結構

描述效能計數器。

語法

typedef struct _PERF_COUNTER_DEFINITION {
  DWORD  ByteLength;
  DWORD  CounterNameTitleIndex;
#if ...
  DWORD  CounterNameTitle;
#else
  LPWSTR CounterNameTitle;
#endif
  DWORD  CounterHelpTitleIndex;
#if ...
  DWORD  CounterHelpTitle;
#else
  LPWSTR CounterHelpTitle;
#endif
  LONG   DefaultScale;
  DWORD  DetailLevel;
  DWORD  CounterType;
  DWORD  CounterSize;
  DWORD  CounterOffset;
} PERF_COUNTER_DEFINITION, *PPERF_COUNTER_DEFINITION;

成員

ByteLength

這個 結構的大小，以位元組為單位。

CounterNameTitleIndex

標題資料庫中計數器名稱的索引。 如需使用索引來擷取計數器名稱的詳細資訊，請參閱 擷取計數器名稱和解說文字。

若要設定此值，提供者會將其符號檔中定義的計數器位移值新增至 第一個計數器 登錄值。 如需詳細資訊，請參閱 將計數器名稱和描述新增至登錄 和 實作 OpenPerformanceData 函式。

如果計數器是基底計數器， (CounterType 包含PERF_COUNTER_BASE旗標) ，這個值應該是零。

CounterNameTitle

保留的。

CounterHelpTitleIndex

索引至標題資料庫中計數器的解說文字。 如需使用索引來擷取計數器解說文字的詳細資訊，請參閱 擷取計數器名稱和解說文字。

若要設定此值，提供者會將其符號檔中定義的計數器位移值新增至 First Help 登錄值。 如需詳細資訊，請參閱 將計數器名稱和描述新增至登錄 和 實作 OpenPerformanceData 函式。

如果計數器是基底計數器， (CounterType 包含PERF_COUNTER_BASE旗標) ，這個值應該是零。

CounterHelpTitle

保留的。

DefaultScale

繪製計數器值時要使用的縮放比例。 有效值的範圍從 -7 到 7 (值對應至 0.0000001 - 100000000) 。 如果此值為零，小數位數值為 1;如果此值為 1，則小數位數值為 10;如果此值為 –1，則小數位數值為 .10;依此類故。

DetailLevel

計數器的詳細資料層級。 取用者會使用此值來控制顯示覆雜度。 這個成員可以是下列其中一個值。

CounterType

計數器的類型。 如需預先定義的計數器類型清單，請參閱 Windows Server 2003 部署套件的計數器類型一節。 取用者會使用計數器類型來決定如何計算和顯示計數器值。 提供者應該將其選擇的計數器類型限制為預先定義的清單。

CounterSize

計數器大小，以位元組為單位。

目前，只有 DWORD (4 個位元組) 和 ULONGLONG (8 個位元組) 用來提供計數器值。

CounterOffset

從 PERF_COUNTER_BLOCK 結構的開頭到這個計數器的第一個位元組的位移。 PERF_OBJECT_TYPE 區塊中PERF_COUNTER_BLOCK結構的位置取決於物件是否包含 實例。 如需詳細資訊，請參閱 效能資料格式。

請注意，多個計數器可以使用相同的原始資料，並指向 PERF_COUNTER_BLOCK 區塊中的相同位移。

備註

PERF_OBJECT_TYPE結構包含一或多個計數器。 這個結構會定義每個計數器，並提供其值的位移。 這些結構會遵循記憶體中的 PERF_OBJECT_TYPE 結構。 如需詳細資訊，請參閱 效能資料格式。

提供者應該在每次查詢計數器時，以相同的順序提供其計數器。 如果計數器在其計算中使用基底計數器， (計數器類型包含 PERF_COUNTER_FRACTION 旗標) ，則基底計數器必須遵循計數器清單中的這個計數器。 如果計數器類型包含 PERF_MULTI_COUNTER 旗標，第二個計數器值必須遵循 PERF_COUNTER_BLOCK 區塊中的這個計數器值。

規格需求

另請參閱

PERF_COUNTER_BLOCK

PERF_OBJECT_TYPE