Função FormatFromRawValue

Artigo
05/10/2023

Converte um valor de dados de desempenho não processado para o formato especificado ou dois valores de dados de desempenho não processados se a conversão do formato for baseada no tempo.

Nota

Esta API destina-se apenas a utilização interna. Não se destina a ser utilizado a partir do código do programador.

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, veja WMI Performance Counter Types (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 de desempenho não processados. Pode ser um dos seguintes valores:

Constante	Valor	Descrição
`PDH_FMT_DOUBLE`	0x00000200	Devolver o valor calculado como um valor de vírgula flutuante de precisão dupla.
`PDH_FMT_LARGE`	0x00000400	Devolver o valor calculado como um número inteiro de 64 bits.
`PDH_FMT_LONG`	0x00000100	Devolver o valor calculado como um número 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 1000.

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

pRawValue1
[in] Um ponteiro para uma PDH_RAW_COUNTER estrutura que representa um valor de desempenho não processado.

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

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

Valor devolvido

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

Constante	Valor	Descrição
`ERROR_SUCCESS`	0	A chamada da função foi efetuada com êxito.
`PDH_INVALID_ARGUMENT`	0xC0000BBD	Um argumento necessário está em falta ou incorreto.
`PDH_INVALID_HANDLE`	0xC0000BBC	O identificador não é um objeto PDH válido.

Observações

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

Requisitos

Plataformas: Veja Requisitos de Sistema.

Biblioteca: PerfCounter.dll

.NET Framework Versões: Disponível desde a versão 4.7.2

Ver também

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

Partilhar via