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 成員。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
標頭 | winperf.h (包含 Windows.h) |