counterSet 复杂类型
定义逻辑相关的计数器列表。
<xs:complexType name="counterSet">
<xs:sequence>
<xs:element name="structs"
type="man:structs"
minOccurs="0"
maxOccurs="1"
/>
<xs:element name="counter"
type="man:counter"
minOccurs="1"
maxOccurs="unbounded"
/>
</xs:sequence>
<xs:attribute name="symbol"
type="man:CSymbolType"
use="required"
/>
<xs:attribute name="guid"
type="man:GUIDType"
use="required"
/>
<xs:attribute name="uri"
type="xs:anyURI"
use="required"
/>
<xs:attribute name="name"
use="required"
>
<xs:simpleType>
<xs:restriction
base="xs:string"
>
<xs:maxLength
value="1023"
/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="description"
type="xs:string"
use="required"
/>
<xs:attribute name="instances"
use="optional"
default="single"
>
<xs:simpleType>
<xs:restriction
base="xs:string"
>
<xs:enumeration
value="single"
/>
<xs:enumeration
value="multiple"
/>
<xs:enumeration
value="globalAggregate"
/>
<xs:enumeration
value="multipleAggregate"
/>
<xs:enumeration
value="globalAggregateHistory"
/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
子元素
属性
名称 |
类型 |
说明 |
description |
xs:string |
计数器集的简短说明。
|
guid |
man:GUIDType |
唯一标识计数器集的 GUID。 如果 GUID 已注册,则计数器集注册失败。 若要更新已注册的计数器集,必须先卸载计数器集,然后再次注册它。
|
instances |
|
确定计数器集是否可以包含多个实例。 下面列出了可能的值: -
单
- 定义计数器集,该计数器集中只能存在一个计数器实例。 如果计数器提供系统范围的度量值(例如物理内存),请指定此值。 这是默认值。
-
多个
- 定义计数器集,计数器集中的多个计数器实例可以存在。 如果计数器提供每个实例的度量值,例如每个进程的处理器时间,请指定此值。
-
globalAggregate
- 定义单个实例计数器集,其中计数器集中的计数器必须从各种活动源聚合。 例如,可以创建一个计数器集,其中包含计算硬盘磁盘读取次数的计数器。 如果计算机有三个硬盘,并且使用者查询磁盘读取次数,则 PERFLIB 将从每个磁盘获取读取次数并求和其各个值。
-
multipleAggregate
- 定义一个多实例计数器集,其中计数器集中的计数器必须跨该计数器的所有实例聚合。 例如,可以为包含度量线程性能的计数器的多线程应用程序创建计数器集, (每个线程将引用计数器集的实例) 。 当使用者查询总线程执行时间计数器时,PERFLIB 将计算每个实例的总线程执行时间。
-
globalAggregateHistory
- 定义单个实例计数器集,其计数器值在使用者的生存期内缓存。 请注意,将缓存计数器集中的所有计数器。 若要仅缓存特定计数器,请使用历史记录属性修饰这些计数器。
使用 globalAggregate 中的磁盘读取示例,将缓存计数器集中的所有计数器值。 如果一个磁盘不可用,该磁盘读取的总字节数的最后一个缓存值仍可供使用者应用程序使用。 |
name |
|
计数器集的显示名称。 必须小于 1,024 个字符。 该名称区分大小写。
|
符号 |
man:CSymbolType |
标识计数器集的符号名称。
CTRPP 工具创建一个 GUID 变量,在调用需要计数器集 GUID (例如 PerfCreateInstance) 的函数时可以使用该变量。 变量名称的形式为 符号名称Guid。 如果在调用 CTRPP 时包含 -prefix 参数,则会将前缀字符串添加到符号名称的开头。
|
uri |
xs:anyURI |
唯一的统一资源标识符,允许用户从任何位置访问计数器集中的计数器。
|
要求
要求 |
值 |
最低受支持的客户端
|
Windows Vista [仅限桌面应用]
|
最低受支持的服务器
|
Windows Server 2008 [仅限桌面应用]
|