PERF_OBJECT_TYPE

The PERF_OBJECT_TYPE structure describes object-specific performance information. This structure is followed by a list of PERF_COUNTER_DEFINITION structures, one for each counter defined for the type of object.

typedef struct _PERF_OBJECT_TYPE {  // pot 
    DWORD  TotalByteLength; 
    DWORD  DefinitionLength; 
    DWORD  HeaderLength; 
    DWORD  ObjectNameTitleIndex; 
    LPWSTR ObjectNameTitle; 
    DWORD  ObjectHelpTitleIndex; 
    LPWSTR ObjectHelpTitle; 
    DWORD  DetailLevel; 
    DWORD  NumCounters; 
    DWORD  DefaultCounter; 
    DWORD  NumInstances; 
    DWORD  CodePage; 
    LARGE_INTEGER PerfTime; 
    LARGE_INTEGER PerfFreq; 
} PERF_OBJECT_TYPE; 
 

Members

TotalByteLength
Contains the length, in bytes, of the object-specific data. This value includes this structure, the PERF_COUNTER_DEFINITION structures, and the PERF_INSTANCE_DEFINITION and PERF_COUNTER_BLOCK structures for each instance. This member specifies the offset from the beginning of this structure to the next PERF_OBJECT_TYPE structure if one exists.
DefinitionLength
Contains the length, in bytes, of the object-specific data. This value includes this structure and the PERF_COUNTER_DEFINITION structures for this object. This member is the offset from the beginning of the PERF_OBJECT_TYPE structure to the first PERF_INSTANCE_DEFINITION structure or to the PERF_COUNTER_DEFINITION structures if there is no instance data.
HeaderLength
Contains the length, in bytes, of this structure. This member is the offset to the first PERF_COUNTER_DEFINITION structure for this object.
ObjectNameTitleIndex
Contains the index to the object's name in the title database.
ObjectNameTitle
Points to the name of the object. This member initially contains NULL, but it can contain a pointer to the actual string once the string is located.
ObjectHelpTitleIndex
Contains the index to the object's Help title in the title database.
ObjectHelpTitle
Points to the title of Help. This member initially contains NULL, but it can contain a pointer to the actual string once the string is located.
DetailLevel
Specifies the level of detail. Applications use this value to control display complexity. This value is the minimum detail level of all the counters for a given object. This member can be one of the following values:
Detail level Meaning
PERF_DETAIL_NOVICE No technical ability is required to understand the counter data.
PERF_DETAIL_ADVANCED The counter data is provided for advanced users.
PERF_DETAIL_EXPERT The counter data is provided for expert users.
PERF_DETAIL_WIZARD The counter data is provided for system designers.

NumCounters
Specifies the number of counters in each counter block. There is one counter block per instance.
DefaultCounter
Specifies the default counter whose information is to be displayed when this object is selected. This member is typically greater than or equal to zero. However, this member may be –1 to indicate that there is no default.
NumInstances
Specifies the number of object instances for which counters are being provided.
CodePage
Specifies the code page. This member is zero if the instance strings are in Unicode. Otherwise, this member is the code-page identifier of the instance names.
PerfTime
Specifies the current value, in counts, of the high-resolution performance counter.
PerfFreq
Specifies the current frequency, in counts per second, of the high-resolution performance counter.

Remarks

If there is only one instance of the object type, the counter definitions are followed by a single PERF_COUNTER_BLOCK structure. This structure is followed by data for each counter. (The PERF_COUNTER_BLOCK structure contains the total length of the structure and the counter data that follows it.)

If there is more than one instance of the object type, the list of counter definitions is followed by a PERF_INSTANCE_DEFINITION structure and a PERF_COUNTER_BLOCK structure for each instance. The PERF_INSTANCE_DEFINITION structure includes the name, the identifier, and the name of the parent of the instance.

Following the counter data, there is a PERF_INSTANCE_DEFINITION structure and a PERF_COUNTER_BLOCK structure for each instance specified in the PERF_DATA_BLOCK structure that begins the performance-data area.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in winperf.h.

See Also

Performance Data Helper Overview, Performance Data Structures, PERF_COUNTER_BLOCK, PERF_COUNTER_DEFINITION, PERF_INSTANCE_DEFINITION