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 .
typedef struct _PCW_COUNTER_DESCRIPTOR {
USHORT Id;
USHORT StructIndex;
USHORT Offset;
USHORT Size;
} PCW_COUNTER_DESCRIPTOR, *PPCW_COUNTER_DESCRIPTOR;
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->Id
PcwAddInstance
.
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).
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.
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) |