Funzione PdhFormatFromRawValue (pdh.h)

Articolo
08/25/2023

Calcola un valore visualizzabile per i valori dei contatori non elaborati specificati.

Sintassi

PDH_FUNCTION PdhFormatFromRawValue(
  [in]  DWORD                 dwCounterType,
  [in]  DWORD                 dwFormat,
  [in]  LONGLONG              *pTimeBase,
  [in]  PPDH_RAW_COUNTER      pRawValue1,
  [in]  PPDH_RAW_COUNTER      pRawValue2,
  [out] PPDH_FMT_COUNTERVALUE pFmtValue
);

Parametri

[in] dwCounterType

Tipo di contatore. In genere, si chiama PdhGetCounterInfo per recuperare il tipo di contatore al momento in cui si chiama PdhGetRawCounterValue per recuperare il valore del contatore non elaborato.

Per un elenco di tipi di contatore, vedere la sezione Tipi di contatore del Kit di distribuzione di Windows Server 2003. I valori costanti sono definiti in Winperf.h.

Si noti che non è possibile specificare tipi di base, ad esempio PERF_LARGE_RAW_BASE.

[in] dwFormat

Determina il tipo di dati del valore calcolato. Specificare uno dei valori seguenti.

Valore	Significato
PDH_FMT_DOUBLE	Restituisce il valore calcolato come virgola mobile a precisione doppia reale.
PDH_FMT_LARGE	Restituisce il valore calcolato come intero a 64 bit.
PDH_FMT_LONG	Restituisce il valore calcolato come intero lungo.

È possibile usare l'operatore OR inclusivo bit per bit (|) per combinare il tipo di dati con uno dei fattori di ridimensionamento seguenti.

Valore	Significato
PDH_FMT_NOSCALE	Non applicare il fattore di ridimensionamento del contatore nel calcolo.
PDH_FMT_NOCAP100	I valori del contatore maggiori di 100 (ad esempio, i valori contatori che misurano il carico del processore nei computer multiprocessore) non verranno reimpostati su 100. Il comportamento predefinito è che i valori dei contatori vengono limitati a un valore pari a 100.
PDH_FMT_1000	Moltiplicare il valore finale per 1.000.

[in] pTimeBase

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. Per recuperare la base temporale del contatore, chiamare PdhGetCounterTimeBase.

[in] pRawValue1

Valore del contatore non elaborato usato per calcolare il valore del contatore visualizzabile. Per informazioni dettagliate, vedere PDH_RAW_COUNTER.

[in] pRawValue2

Valore del contatore non elaborato usato per calcolare il valore del contatore visualizzabile. Per informazioni dettagliate, vedere PDH_RAW_COUNTER. Alcuni contatori, ad esempio i contatori della frequenza, richiedono due valori non elaborati per calcolare un valore visualizzabile. Se il tipo di contatore non richiede un secondo valore, impostare questo parametro su NULL. Questo valore deve essere il valore precedente dei due valori non elaborati.

[out] pFmtValue

Struttura PDH_FMT_COUNTERVALUE che riceve il valore del contatore calcolato.

Valore restituito

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema o un codice di errore PDH.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	pdh.h
Libreria	Pdh.lib
DLL	Pdh.dll

Vedi anche

PDH_FMT_COUNTERVALUE

PDH_RAW_COUNTER

PdhGetCounterInfo

PdhGetCounterTimeBase

PdhGetRawCounterValue

PdhReadRawLogRecord

Condividi tramite