Função FormatFromRawValue

Artigo
05/10/2023

Converte um valor de dados de desempenho brutos para o formato especificado, ou dois valores de dados de desempenho brutos se a conversão de formato é baseada em tempo.

Observação

Esta API é somente para uso interno. Ela não é destinada ao uso do código do desenvolvedor.

Sintaxe

int FormatFromRawValue (
   [in] uint                    dwCounterType,
   [in] uint                    dwFormat,
   [in] long*                   pTimeBase,
   [in] PDH_RAW_COUNTER*        pRawValue1,
   [in] PDH_RAW_COUNTER*        pRawValue2,
   [out] PDH_FMT_COUNTERVALUE*  pFmtValue
);

Parâmetros

dwCounterType
[in] O tipo de contador. Para obter uma lista de tipos de contador, consulte Tipos de contador de desempenho WMI. dwCounterType pode ser qualquer tipo de contador, exceto para PERF_LARGE_RAW_FRACTION e PERF_LARGE_RAW_BASE.

dwFormat
[in] O formato para o qual converter os dados brutos de desempenho. Pode ser um dos seguintes valores:

Constante	Valor	Descrição
`PDH_FMT_DOUBLE`	0x00000200	Retornar o valor calculado como um valor de ponto flutuante de precisão dupla.
`PDH_FMT_LARGE`	0x00000400	Retornar o valor calculado como um inteiro de 64 bits.
`PDH_FMT_LONG`	0x00000100	Retornar o valor calculado como um inteiro de 32 bits.

Um dos valores anteriores pode ser ORed com um dos seguintes sinalizadores de dimensionamento:

Constante	Valor	Descrição
`PDH_FMT_NOSCALE`	0x00001000	Não aplique os fatores de dimensionamento do contador.
`PDH_FMT_1000`	0x00002000	Multiplique o valor final por 1.000.

pTimeBase
[in] Um ponteiro para a base de tempo, se necessário, para a conversão de formato. Se as informações de base de tempo não forem necessárias para a conversão de formato, o valor desse parâmetro será ignorado.

pRawValue1
[in] Um ponteiro para uma estrutura PDH_RAW_COUNTER que representa um valor de desempenho bruto.

pRawValue2
[in] Um ponteiro para uma estrutura PDH_RAW_COUNTER que representa um valor de desempenho bruto. Se um segundo valor de desempenho bruto não for necessário, esse parâmetro deverá ser null.

pFmtValue
[out] Um ponteiro para uma estrutura PDH_FMT_COUNTERVALUE que recebe o valor de desempenho formatado.

Valor retornado

Os seguintes valores são retornados por esta função:

Constante	Valor	Descrição
`ERROR_SUCCESS`	0	A chamada de função foi bem-sucedida.
`PDH_INVALID_ARGUMENT`	0xC0000BBD	Um argumento necessário está ausente ou incorreto.
`PDH_INVALID_HANDLE`	0xC0000BBC	O identificador não é um objeto PDH válido.

Comentários

Essa função encapsula uma chamada para a função FormatFromRawValue.

Requisitos

Plataformas: confira Requisitos do sistema.

Biblioteca: PerfCounter.dll

Versões do .NET Framework: Disponíveis desde 4.7.2

Confira também

WMI e Contadores de Desempenho (Referência de API Não Gerenciada)

Compartilhar via