estrutura PCW_COUNTER_DESCRIPTOR (wdm.h)

Artigo
02/07/2025

A estrutura PCW_COUNTER_DESCRIPTOR é usada para fornecer informações sobre um valor de contador durante o registro de contador. A maioria dos desenvolvedores não precisa acessar essa estrutura diretamente porque ela é gerenciada automaticamente pelo código de registro de contador 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 campo id de um elemento de contador no manifesto do contraconjunto do provedor.

StructIndex

Um valor numérico que especifica um índice em uma matriz de estruturas PCW_DATA. Nas 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 campo StructIndex. Nas chamadas subsequentes para PcwCreateInstance ou PcwAddInstance, o endereço PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset será usado como o início do valor para o contador com a ID PcwCounterDescriptor->Id.

Size

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

Observações

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

Uma matriz de estruturas de PCW_COUNTER_DESCRIPTOR é 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 matriz de PCW_DATA.

Requisitos

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

Consulte também

estrutura _PCW_REGISTRATION_INFORMATION

estrutura _PCW_DATA

CTRPP

contador de Tipo Complexo

Partilhar via