Ler em inglês

Compartilhar via


estrutura PCW_COUNTER_DESCRIPTOR (wdm.h)

A PCW_COUNTER_DESCRIPTOR estrutura é usada para fornecer informações sobre um valor de contador durante o registro do contador. A maioria dos desenvolvedores não precisa acessar essa estrutura diretamente porque ela é gerenciada automaticamente pelo código de registro de contraconjunto gerado pela ferramenta CTRPP .

Sintaxe

typedef struct _PCW_COUNTER_DESCRIPTOR {
  USHORT Id;
  USHORT StructIndex;
  USHORT Offset;
  USHORT Size;
} PCW_COUNTER_DESCRIPTOR, *PPCW_COUNTER_DESCRIPTOR;

Membros

Id

Um valor numérico que especifica a ID do contador descrito por essa estrutura. Isso deve corresponder ao valor fornecido no id campo de um elemento de contador no manifesto do contador do provedor.

StructIndex

Um valor numérico que especifica um índice em uma matriz de estruturas PCW_DATA . Em chamadas subsequentes para PcwCreateInstance ou PcwAddInstance, o bloco de dados descrito por PcwData[PcwCounterDescriptor->StructIndex] será usado como a fonte de dados para o contador com a ID PcwCounterDescriptor->Id.

Offset

Um valor numérico que especifica um deslocamento (em bytes) em relação ao bloco de dados indicado pelo StructIndex campo. Nas chamadas subsequentes para PcwCreateInstance ou , o endereço PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset será usado como o início do valor para o contador com a ID PcwCounterDescriptor->IdPcwAddInstance.

Size

Um valor numérico que especifica o tamanho, em bytes, do valor do contador com a ID PcwCounterDescriptor->Id. O Size campo deve ser definido como 4 (para um UINT32 valor de contador) ou 8 (para um UINT64 valor de contador).

Comentários

A maioria dos desenvolvedores não precisa usar essa estrutura diretamente. A CTRPP ferramenta gera o código de registro que inicializa estruturas PCW_COUNTER_DESCRIPTOR com base no conteúdo do manifesto do provedor.

Uma matriz de PCW_COUNTER_DESCRIPTOR estruturas é fornecida durante o registro de contraconjunto (por meio da estrutura PCW_REGISTRATION_INFORMATION passada para PcwRegister). As informações da matriz são registradas e serão usadas por PcwCreateInstance ou PcwAddInstance para extrair valores de contador dos blocos de dados descritos por uma PCW_DATA matriz.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 7 e versões posteriores do Windows.
Cabeçalho wdm.h (inclua Wdm.h, Ntddk.h)

Confira também

estrutura _PCW_REGISTRATION_INFORMATION

estrutura _PCW_DATA

CTRPP

tipo complexo de contador