Funzione FormatFromRawValue

Articolo
05/10/2023

Converte un valore di dati sulle prestazioni non elaborati nel formato specificato o due valori di dati sulle prestazioni non elaborati se la conversione del formato è basata sul tempo.

Nota

Questa API è solo per uso interno. Non è destinata all'uso dal codice dello sviluppatore.

Sintassi

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

Parametri

dwCounterType
[in] Tipo di contatore. Per un elenco di tipi di contatore, vedere Tipi di contatore delle prestazioni WMI. dwCounterType può essere qualsiasi tipo di contatore ad eccezione PERF_LARGE_RAW_FRACTION di e PERF_LARGE_RAW_BASE.

dwFormat
[in] Formato in cui convertire i dati delle prestazioni non elaborati. Può essere uno dei valori seguenti:

Costante	Valore	Descrizione
`PDH_FMT_DOUBLE`	0x00000200	Restituisce il valore calcolato come valore a virgola mobile a precisione doppia.
`PDH_FMT_LARGE`	0x00000400	Restituisce il valore calcolato come intero a 64 bit.
`PDH_FMT_LONG`	0x00000100	Restituisce il valore calcolato come intero a 32 bit.

Uno dei valori precedenti può essere ORed con uno dei flag di ridimensionamento seguenti:

Costante	Valore	Descrizione
`PDH_FMT_NOSCALE`	0x00001000	Non applicare i fattori di ridimensionamento del contatore.
`PDH_FMT_1000`	0x00002000	Moltiplicare il valore finale per 1.000.

pTimeBase
[in] Puntatore alla base temporale, se necessario per la conversione del formato. Se le informazioni sulla base temporale non sono necessarie per la conversione del formato, il valore di questo parametro viene ignorato.

pRawValue1
[in] Puntatore a una PDH_RAW_COUNTER struttura che rappresenta un valore di prestazioni non elaborato.

pRawValue2
[in] Puntatore a una PDH_RAW_COUNTER struttura che rappresenta un secondo valore di prestazioni non elaborato. Se non è necessario un secondo valore di prestazioni non elaborato, questo parametro deve essere null.

pFmtValue
[out] Puntatore a una PDH_FMT_COUNTERVALUE struttura che riceve il valore di prestazioni formattato.

Valore restituito

I valori seguenti vengono restituiti da questa funzione:

Costante	Valore	Descrizione
`ERROR_SUCCESS`	0	La chiamata alla funzione ha esito positivo.
`PDH_INVALID_ARGUMENT`	0xC0000BBD	Un argomento obbligatorio non è corretto o mancante.
`PDH_INVALID_HANDLE`	0xC0000BBC	L'handle non è un oggetto PDH valido.

Commenti

Questa funzione esegue il wrapping di una chiamata alla funzione FormatFromRawValue .

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Libreria: PerfCounter.dll

Versioni di .NET Framework: Disponibile da 4.7.2

Vedi anche

WMI e contatori delle prestazioni (riferimenti alle API non gestite)

Condividi tramite