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) |