通过

PDH_COUNTER_INFO_A 结构 (pdh.h)

  • 项目

PDH_COUNTER_INFO 结构包含描述计数器属性的信息。 此信息还包括计数器路径。

语法

typedef struct _PDH_COUNTER_INFO_A {
  DWORD     dwLength;
  DWORD     dwType;
  DWORD     CVersion;
  DWORD     CStatus;
  LONG      lScale;
  LONG      lDefaultScale;
  DWORD_PTR dwUserData;
  DWORD_PTR dwQueryUserData;
  LPSTR     szFullPath;
  union {
    PDH_DATA_ITEM_PATH_ELEMENTS_A DataItemPath;
    PDH_COUNTER_PATH_ELEMENTS_A   CounterPath;
    struct {
      LPSTR szMachineName;
      LPSTR szObjectName;
      LPSTR szInstanceName;
      LPSTR szParentInstance;
      DWORD dwInstanceIndex;
      LPSTR szCounterName;
    };
  };
  LPSTR     szExplainText;
  DWORD     DataBuffer[1];
} PDH_COUNTER_INFO_A, *PPDH_COUNTER_INFO_A;

成员

dwLength

结构的大小（包括追加的字符串），以字节为单位。

dwType

计数器类型。 有关计数器类型的列表，请参阅 Windows Server 2003 部署工具包的计数器类型部分。 计数器类型常量在 Winperf.h 中定义。

CVersion

计数器版本信息。 未使用。

CStatus

指示计数器值是否有效的计数器状态。 有关可能值的列表，请参阅 检查 PDH 接口返回值。

lScale

计算计数器的可显示值时要使用的比例系数。 比例系数为 10 的幂。 此参数的有效范围为 PDH_MIN_SCALE (–7，) (返回的值是实际值乘以 10–⁷) PDH_MAX_SCALE (+7，) (返回的值是实际值乘以 10⁺⁷) 。 值为零会将刻度设置为 1，以便返回实际值

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）分配足够的内存。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 pdh.h

另请参阅

PDH_COUNTER_PATH_ELEMENTS

PDH_DATA_ITEM_PATH_ELEMENTS

PdhGetCounterInfo