estrutura PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR (ntddk.h)

A estrutura PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR descreve os recursos de contador disponíveis na plataforma.

Sintaxe

typedef struct _PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR {
  PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE Type;
  ULONG                                     Flags;
  union {
    ULONG                                       CounterIndex;
    struct {
      ULONG Begin;
      ULONG End;
    } Range;
    PPHYSICAL_COUNTER_OVERFLOW_HANDLER          OverflowHandler;
    PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION EventBufferConfiguration;
    ULONG                                       IdentificationTag;
  } u;
} PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR, *PPHYSICAL_COUNTER_RESOURCE_DESCRIPTOR;

Membros

Type

Indica o tipo de recurso de contador descrito pela estrutura . Defina esse parâmetro como uma das seguintes constantes de enumeração PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE :

• ResourceTypeSingle
• ResourceTypeRange
• ResourceTypeOverflow
• ResourceTypeEventBuffer

Flags

Nenhum sinalizador está definido no momento. Defina esse membro como zero.

u

Uma união que pode conter um valor CounterIndex, Range, OverflowHandler ou EventBufferConfiguration .

u.CounterIndex

Um índice de contador físico.

u.Range

Um intervalo de índices de contador.

u.Range.Begin

O índice do contador inicial de um bloco de contadores contíguos.

u.Range.End

O índice de contador final de um bloco de contadores contíguos.

u.OverflowHandler

Um ponteiro para a rotina de PPHYSICAL_COUNTER_OVERFLOW_HANDLER fornecida pelo driver que será chamada quando um contador de hardware associado (especificado por outro PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR) estourar.

u.EventBufferConfiguration

Uma configuração para amostragem baseada em buffer de eventos (como o PEBS da Intel). Os campos de configuração são definidos pelo tipo PHYSICAL_COUNTER_EVENT_BUFFER_CONFIGURATION .

u.IdentificationTag

Comentários

A maioria dos processadores tem unidades de monitor de desempenho que contêm vários contadores de hardware para medir vários aspectos do desempenho do sistema. A estrutura PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR descreve um recurso de contador, que pode ser um único contador de hardware, um bloco de contadores contíguos, uma interrupção de estouro de contador ou uma configuração de buffer de eventos. O membro Type dessa estrutura indica qual tipo de recurso de contador é descrito pela estrutura .

Para especificar um conjunto de recursos de contador, um cliente no modo kernel pode fornecer uma matriz de estruturas de PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR . Uma estrutura PHYSICAL_COUNTER_RESOURCE_LIST serve como um cabeçalho para a matriz. O cliente pode alocar e liberar o conjunto de recursos de contador descritos pela matriz como uma única unidade. Para fazer isso, o driver chama HalAllocateHardwareCounters e HalFreeHardwareCounters

Requisitos

Confira também

PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE

PHYSICAL_COUNTER_RESOURCE_LIST