7.2 效能监视.htm

Windows2000后台服务程序开发手册

              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>NumInstances</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>指示物件目前拥有多少实例。如图7-9所示，物件没有支援实例，所以会回传PERF_NO_INSTANCES（-1）。</FONT></TD></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>CodePage</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>如果物件支援实例，那么每一个实例皆以字串名称的形式而被回传。最好以Unicode字串格式来回传实例名称，所以设定此成员为0。然而，如果您较偏好回传非Unicode字串，那么就为实例字串名称设定为使用CodePage。</FONT></TD></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>PerfTime PerfFreq</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>应该永远被设定为0，因为这些函数只有在应用程序要求资料时才会被使用。</FONT></TD></TR></TBODY></TABLE></CENTER>
            <P><FONT style="LINE-HEIGHT: 25px" face=arial color=#000000 
            size=2>紧接在PERF_OBJECT_TYPE结构后的是一或多个PERF_COUNTER_DEFINITION结构，一个为每个被物件提供之计数器的结构。表7-2提供此结构成员之简短说明。</FONT></P>
            <CENTER style="LINE-HEIGHT: 25px">
            <TABLE style="LINE-HEIGHT: 25px" border=0>
              <TBODY style="LINE-HEIGHT: 25px">
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px" align=middle><FONT 
                  style="LINE-HEIGHT: 25px" face=arial color=#000000 
                  size=2><FONT style="LINE-HEIGHT: 25px" face=arial 
                  color=#3e80d7 size=2><B 
                  style="LINE-HEIGHT: 25px">&nbsp;表7-2&nbsp;</B></FONT>PERF_COUNTER_DEFINITION结构成员</FONT></TD></TR></TBODY></TABLE></CENTER>
            <CENTER style="LINE-HEIGHT: 25px">
            <TABLE style="LINE-HEIGHT: 25px" border=1>
              <TBODY style="LINE-HEIGHT: 25px">
              <TR style="LINE-HEIGHT: 25px">
                <TH style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>成员</FONT> </TH>
                <TH style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>说明</FONT></TH></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>ByteLength</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>此结构的位元组长度。为了在此内存区块中移动而使用。</FONT></TD></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>CounterNameTitleIndex CounterHelpTitleIndex</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>当计数器和说明文字被加至登录中，指示被指定至计数器及说明的文字。</FONT></TD></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>CounterNameTitle CounterHelpTitle</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>应该永远被设定为NULL值，因为这些成员只有在应用程序要求资料时才被使用。</FONT></TD></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>DefaultScale</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>将要扩充的图表线段放大10倍，假设垂直轴为100（0说明一个扩充值为1，1表示扩充值为10，_1则说明1/10的扩充值等等）。</FONT></TD></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>DetailLevel</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>为大部份使用者指示此计数器的「理解程度」。多数的计数器是初学者可了解的。然而您还是可以说明您的计数器为初学者、进阶使用者、专家或者高阶使用者所能理解。</FONT></TD></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>CounterType</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>计数器的类型（请参阅WinPerf.h标头档内容以取得说明）。</FONT></TD></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>CounterSize</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>计数器资讯所使用的位元组数（通常为4或8位元组）。</FONT></TD></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>CounterOffset</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>从PERF_COUNTER_BLOCK开始至此计数器之第一个位元组的偏移量。</FONT></TD></TR></TBODY></TABLE></CENTER>
            <P><FONT style="LINE-HEIGHT: 25px" face=arial color=#000000 
            size=2>每一个PERF_COUNTER_DEFINITION结构皆定义了单一计数器的特征，但是计数器的实际值则不会从这些结构中回传。在PERF_OBJECT_TYPE结构以及所有PERF_COUNTER_DEFINITION结构之后是一个单一的PERF_COUNTER_BLOCK结构。PERF_COUNTER_BLOCK是一个长度可变的结构。它的第一个成员为ByteLength说明了在长度可变之结构中有多少位元组（必须包括此成员本身之4位元组）。紧接在此成员后是计数器的值。非常重要的一点是，必须使每一个新值都以32位元为界限而对齐，否则会发生错误例外的情形。</FONT></P>
            <P><FONT style="LINE-HEIGHT: 25px" face=arial color=#000000 
            size=2>在PERF_COUNTER_DEFINITION结构内部的CounterSize成员指示有多少位元组已被计数器值使用，而CounterOffset成员则说明位于PERF_COUNTER_BLOCK结构内之计数器值的偏移量。</FONT></P>
            <P><FONT style="LINE-HEIGHT: 25px" face=arial color=#000000 
            size=2>图7-10显示如何安排一个支援实例之物件的效能资讯。此特定的物件为每一个实例提供了计数器，而且目前拥有二个被定义的实例。因为只有一个计数器被定义，所以登录中的这个物件只存在二个字串项目：一个字串确认了物件名称并被指定一个2944的值；只一个字串则确定计数器名称，而且其值被指定为2946。物件及计数器的说明文字分别为2945及2947。</FONT></P>
            <P><BR style="LINE-HEIGHT: 25px">　</P>
            <CENTER style="LINE-HEIGHT: 25px">
            <P><INPUT id=10 style="LINE-HEIGHT: 25px" type=image height=630 
            width=748 src="7.2 效能监视.files/7-10.gif" border=0 
            &#111nclick="imgclick"></P></CENTER>
            <CENTER style="LINE-HEIGHT: 25px">
            <TABLE style="LINE-HEIGHT: 25px" border=0>
              <TBODY style="LINE-HEIGHT: 25px">
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px" align=middle><FONT 
                  style="LINE-HEIGHT: 25px" face=arial color=#000000 
                  size=2><FONT style="LINE-HEIGHT: 25px" face=arial 
                  color=#3e80d7 size=2><B 
                  style="LINE-HEIGHT: 25px">&nbsp;图7-10&nbsp;</B></FONT>描述一个效能物件与二个实例的资料缓冲区，所有实例计数器值皆位于缓冲区中</FONT></TD></TR></TBODY></TABLE></CENTER>
            <P><FONT style="LINE-HEIGHT: 25px" face=arial color=#000000 
            size=2>这个内存区块开始处的安排就如同先前所提的范例一样：它以一个PERF_OBJECT_TYPE结构开始，其后则跟随着每一个由物件提供的计数器PERF_COUNTER_DEFINITION结构。然而，这是与结束相似的地方。由于此物件支援实例，接在PERF_COUNTER_DEFINITION结构后则是目前存在物件内之每个实例的PERF_INSTANCE_DEFINITION结构。表7-3对PERF_INSTANCE_DEFINITION结构的成员做了一个简短的说明。</FONT></P>
            <CENTER style="LINE-HEIGHT: 25px">
            <TABLE style="LINE-HEIGHT: 25px" border=0>
              <TBODY style="LINE-HEIGHT: 25px">
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px" align=middle><FONT 
                  style="LINE-HEIGHT: 25px" face=arial color=#000000 
                  size=2><FONT style="LINE-HEIGHT: 25px" face=arial 
                  color=#3e80d7 size=2><B 
                  style="LINE-HEIGHT: 25px">&nbsp;表7-3&nbsp;</B></FONT>PERF_INSTANCE_DEFINITION结构的成员</FONT></TD></TR></TBODY></TABLE></CENTER>
            <CENTER style="LINE-HEIGHT: 25px">
            <TABLE style="LINE-HEIGHT: 25px" border=1>
              <TBODY style="LINE-HEIGHT: 25px">
              <TR style="LINE-HEIGHT: 25px">
                <TH style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>成员</FONT> </TH>
                <TH style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>说明</FONT></TH></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>ByteLength</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>此结构的位元组长度。为了在内存区块中移动而使用。</FONT></TD></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>ParentObjectTitleIndex</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>例可以是另一个子物件或子实例；例如，线程即是一个子处理程序。如果实例拥有一个父实例，此数字则代表被父物件指定的登录数字（0=no 
                  parent）。</FONT></TD></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>ParentObjectInstance</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>如果此实例拥有父实例，则此数字确认了与父实例之索引有关的父物件。</FONT></TD></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>UniqueID</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>一个实例可以被一个数字或一个字串名称所确认。如果您想要使用一个数字，只需设定此成员为该数字并将NameOffset和NameLength设定为0即可。如果您想要使用一个字串名称，则将此成员设定为-1，并适当地设定NameOffset和NameLength成员。</FONT></TD></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>NameOffset</FONT></TD>
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>从结构开始至此实例的Unicode字串名称之位元组数字。</FONT></TD></TR>
              <TR style="LINE-HEIGHT: 25px">
                <TD style="LINE-HEIGHT: 25px"><FONT style="LINE-HEIGHT: 25px" 
                  size=2>NameLength</FONT></TD>