Compartir a través de

estructura PERFORMANCE_DATA (winnt.h)

  • Artículo

Contiene los datos del contador de hardware y la generación de perfiles de subprocesos que solicitó.

Sintaxis

typedef struct _PERFORMANCE_DATA {
  WORD                  Size;
  BYTE                  Version;
  BYTE                  HwCountersCount;
  DWORD                 ContextSwitchCount;
  DWORD64               WaitReasonBitMap;
  DWORD64               CycleTime;
  DWORD                 RetryCount;
  DWORD                 Reserved;
  HARDWARE_COUNTER_DATA HwCounters[MAX_HW_COUNTERS];
} PERFORMANCE_DATA, *PPERFORMANCE_DATA;

Miembros

Size

Tamaño de esta estructura.

Version

Versión de esta estructura. Debe establecerse en PERFORMANCE_DATA_VERSION.

HwCountersCount

Número de elementos de matriz de la matriz HwCounters que contienen datos de contador de hardware. Un valor de 3 significa que la matriz contiene datos de tres contadores de hardware, no que los elementos del 0 al 2 contienen datos de contador.

ContextSwitchCount

Número de modificadores de contexto que se produjeron a partir del momento en que se ha habilitado la generación de perfiles.

WaitReasonBitMap

Máscara de bits que identifica los motivos de los modificadores de contexto que se produjeron desde la última vez que se leyeron los datos. Para obtener los valores posibles, vea la enumeración KWAIT_REASON (la enumeración se incluye en el archivo Wdm.h en WDK).

CycleTime

El tiempo de ciclo del subproceso (excluye el tiempo invertido interrumpido) del tiempo que se ha habilitado la generación de perfiles.

RetryCount

Número de veces que la operación de lectura lee los datos para garantizar una instantánea coherente de los datos.

Reserved

Reservado. Establecer en cero.

HwCounters[MAX_HW_COUNTERS]

Matriz de estructuras de HARDWARE_COUNTER_DATA que contienen los valores de contador. Los elementos de la matriz que contienen datos de contador se relacionan directamente con los bits establecidos en la máscara de bits HardwareCounters que especificó al llamar a la función EnableThreadProfiling . Por ejemplo, si establece el bit 3 en la máscara de bits HardwareCounters , HwCounters[3] contendrá los datos del contador para ese contador.

Comentarios

Debe inicializar los miembros Size y Version antes de llamar a la función ReadThreadProfilingData para leer los datos de generación de perfiles.

Los datos de perfil contenidos en esta estructura dependen de los datos solicitados al llamar a la función ReadThreadProfilingData . Los miembros siguientes se establecen al especificar la marca READ_THREAD_PROFILING_FLAG_DISPATCHING:

  • ContextSwitchCount
  • CycleTime
  • RetryCount
  • WaitReasonBitMap
Los miembros siguientes se establecen al especificar la marca READ_THREAD_PROFILING_FLAG_HARDWARE_COUNTERS:
  • HwCounters
  • HwCountersCount

Requisitos

   
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado winnt.h (incluye Windows.h)

Consulte también

ReadThreadProfilingData