PERF_DATA_BLOCK 結構 (winperf.h)

描述您查詢的效能數據區塊，例如提供者傳回的效能物件數目，以及計算效能值時所使用的時間型值。

語法

typedef struct _PERF_DATA_BLOCK {
  WCHAR         Signature[4];
  DWORD         LittleEndian;
  DWORD         Version;
  DWORD         Revision;
  DWORD         TotalByteLength;
  DWORD         HeaderLength;
  DWORD         NumObjectTypes;
  LONG          DefaultObject;
  SYSTEMTIME    SystemTime;
  LARGE_INTEGER PerfTime;
  LARGE_INTEGER PerfFreq;
  LARGE_INTEGER PerfTime100nSec;
  DWORD         SystemNameLength;
  DWORD         SystemNameOffset;
} PERF_DATA_BLOCK, *PPERF_DATA_BLOCK;

成員

Signature[4]

包含 「PERF」 的四個寬字元陣列。

LittleEndian

指出計數器值是否為大端格式或小尾格式。 如果有的話，計數器值會以小到尾格式。 如果為零，計數器值會以大端格式表示。 如果您從外部計算機擷取效能數據，此值可能是零 (大端格式) ，例如 UNIX 電腦。

Version

效能結構的版本。

Revision

效能結構的修訂。

TotalByteLength

效能數據區塊的大小總計，以位元組為單位。

HeaderLength

這個結構的大小，以位元組為單位。 您可以使用標頭長度來尋找效能數據區塊中的第一 個PERF_OBJECT_TYPE 結構。

NumObjectTypes

效能數據區塊中的效能物件數目。

DefaultObject

保留的。

SystemTime

監視系統的時間。 此成員的格式為國際標準時間 (UTC) 格式。

PerfTime

受監視之系統的性能計數器值，以計數為單位。 如需詳細資訊，請參閱 QueryPerformanceCounter。

PerfFreq

受監視系統的每秒計數性能計數器頻率。 如需詳細資訊，請參閱 QueryPerformanceFrequency。

PerfTime100nSec

受監視系統的性能計數器值，以 100 奈秒為單位。 如需詳細資訊，請參閱 GetSystemTimeAsFileTime。

SystemNameLength

位於 SystemNameOffset 的電腦名稱大小，以位元組為單位。

SystemNameOffset

從這個結構的開頭位移到受監視電腦的 Unicode 名稱。

備註

當取用者呼叫 RegQueryValueEx 以擷取一或多個效能物件時，會傳回效能數據區塊。 這個結構是傳回區塊中的第一個結構。 區塊中的下一個結構是定義效能物件的 PERF_OBJECT_TYPE 結構。 如需效能數據區塊配置的詳細資訊，請參閱 效能數據格式。

取用者會在計算計數器值時使用 PerfTime、PerfFreq 和 PerfTime100nSec，除非計數器類型包含PERF_OBJECT_TIMER旗標，在此情況下，取用者會使用 PERF_OBJECT_TYPE 的 PerfTime 和 PerfFreq 成員。

規格需求

另請參閱

PERF_OBJECT_TYPE

效能數據格式