estructura PERF_OBJECT_TYPE (winperf.h)

  • Artículo

Describe información de rendimiento específica del objeto, por ejemplo, el número de instancias del objeto y el número de contadores que define el objeto.

Sintaxis

typedef struct _PERF_OBJECT_TYPE {
  DWORD         TotalByteLength;
  DWORD         DefinitionLength;
  DWORD         HeaderLength;
  DWORD         ObjectNameTitleIndex;
#if ...
  DWORD         ObjectNameTitle;
#else
  LPWSTR        ObjectNameTitle;
#endif
  DWORD         ObjectHelpTitleIndex;
#if ...
  DWORD         ObjectHelpTitle;
#else
  LPWSTR        ObjectHelpTitle;
#endif
  DWORD         DetailLevel;
  DWORD         NumCounters;
  LONG          DefaultCounter;
  LONG          NumInstances;
  DWORD         CodePage;
  LARGE_INTEGER PerfTime;
  LARGE_INTEGER PerfFreq;
} PERF_OBJECT_TYPE, *PPERF_OBJECT_TYPE;

Miembros

TotalByteLength

Tamaño de los datos específicos del objeto, en bytes. Este miembro es el desplazamiento desde el principio de esta estructura hasta la siguiente estructura PERF_OBJECT_TYPE , si existe.

DefinitionLength

Tamaño de esta estructura más el tamaño de todos los
PERF_COUNTER_DEFINITION estructuras.

Si el objeto es un objeto de instancia múltiple (el miembro NumInstances no es cero), este miembro es el desplazamiento desde el principio de esta estructura hasta la primera estructura PERF_INSTANCE_DEFINITION . De lo contrario, este valor es el desplazamiento al PERF_COUNTER_BLOCK.

HeaderLength

Tamaño de esta estructura, en bytes. Este miembro es el desplazamiento desde el principio de esta estructura hasta la primera estructura PERF_COUNTER_DEFINITION .

ObjectNameTitleIndex

Indexe al nombre del objeto en la base de datos de título. Para obtener más información sobre cómo usar el índice para recuperar el nombre del objeto, vea Recuperación de nombres de contadores y texto de ayuda.

Los proveedores especifican el valor de índice en su archivo de inicialización. Para obtener más información, vea Agregar nombres y descripciones de contadores al Registro.

ObjectNameTitle

Reservado.

ObjectHelpTitleIndex

Indexe el texto de ayuda del objeto en la base de datos de título. Para obtener más información sobre cómo usar el índice para recuperar el texto de ayuda del objeto, consulte Recuperación de nombres de contadores y texto de ayuda.

Los proveedores especifican el valor de índice en su archivo de inicialización. Para obtener más información, vea Agregar nombres y descripciones de contadores al Registro.

ObjectHelpTitle

Reservado.

DetailLevel

Nivel de detalle. Los consumidores usan este valor para controlar la complejidad de la visualización. Este valor es el nivel de detalle mínimo de todos los contadores de un objeto determinado. Este miembro puede ser uno de los valores siguientes.

Nivel de detalle Significado
PERF_DETAIL_NOVICE
 Los datos del contador se proporcionan para todos los usuarios.
PERF_DETAIL_ADVANCED
 Los datos del contador se proporcionan para los usuarios avanzados.
PERF_DETAIL_EXPERT
 Los datos del contador se proporcionan para los usuarios expertos.
PERF_DETAIL_WIZARD
 Los datos del contador se proporcionan para los diseñadores del sistema.

NumCounters

Número de bloques de PERF_COUNTER_DEFINITION devueltos por el objeto .

DefaultCounter

Indexe al nombre del contador en la base de datos de título del contador predeterminado cuya información se va a mostrar cuando se selecciona este objeto en la herramienta Rendimiento. Este miembro puede ser –1 para indicar que no hay ningún valor predeterminado.

NumInstances

Número de instancias de objeto para las que se proporcionan contadores. Si el objeto puede tener cero o más instancias, pero no tiene ninguna en la actualidad, este valor debe ser cero. Si el objeto no puede tener varias instancias, este valor debe ser PERF_NO_INSTANCES.

CodePage

Este miembro es cero si las cadenas de instancia son cadenas Unicode. De lo contrario, este miembro es el identificador de página de códigos de los nombres de instancia. Puede usar el valor de página de códigos al llamar a MultiByteToWideChar para convertir la cadena en Unicode.

PerfTime

Marca de tiempo generada por el proveedor que los consumidores usan al calcular valores de contador. Por ejemplo, podría ser el valor actual, en recuentos, del contador de rendimiento de alta resolución.

Los proveedores deben proporcionar este valor si los tipos de contador de sus contadores incluyen la marca PERF_OBJECT_TIMER . De lo contrario, los consumidores usan el valor PerfTime de PERF_DATA_BLOCK.

PerfFreq

Valor de frecuencia generado por el proveedor que los consumidores usan al calcular los valores de contador. Por ejemplo, podría ser la frecuencia actual, en recuentos por segundo, del contador de rendimiento de alta resolución.

Los proveedores deben proporcionar este valor si los tipos de contador de sus contadores incluyen la marca PERF_OBJECT_TIMER . De lo contrario, los consumidores usan el valor PerfFreq de PERF_DATA_BLOCK.

Comentarios

Los proveedores usan esta estructura para proporcionar datos de rendimiento para los objetos que admiten. Los consumidores usan esta estructura para consumir datos de rendimiento de los objetos que consultaron.

Esta estructura va seguida de una lista de estructuras de PERF_COUNTER_DEFINITION , una para cada contador definido para el objeto de rendimiento. Para más información sobre el diseño del bloque de datos de rendimiento, consulte Formato de datos de rendimiento.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado winperf.h (incluye Windows.h)

Consulte también

PERF_COUNTER_DEFINITION

PERF_DATA_BLOCK

Formato de datos de rendimiento