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

指示计数器值是采用大 endian 格式还是小 endian 格式。 如果为 ，则计数器值采用小端号格式。 如果为零，则计数器值采用大 endian 格式。 如果从外部计算机（如 UNIX 计算机）检索性能数据，则此值可能是零 (大 endian 格式) 。

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)

另请参阅

PERF_OBJECT_TYPE

性能数据格式