Funzione PdhCalculateCounterFromRawValue (pdh.h)

Articolo
03/05/2024

Calcola il valore visualizzabile di due valori di contatore non elaborati.

Sintassi

PDH_FUNCTION PdhCalculateCounterFromRawValue(
  [in]  PDH_HCOUNTER          hCounter,
  [in]  DWORD                 dwFormat,
  [in]  PPDH_RAW_COUNTER      rawValue1,
  [in]  PPDH_RAW_COUNTER      rawValue2,
  [out] PPDH_FMT_COUNTERVALUE fmtValue
);

Parametri

[in] hCounter

Gestire il contatore da calcolare. La funzione usa le informazioni del contatore per determinare come calcolare il valore. Questo handle viene restituito dalla funzione PdhAddCounter .

[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 reale a virgola mobile e precisione doppia.
PDH_FMT_LARGE	Restituisce il valore calcolato come intero a 64 bit.
PDH_FMT_LONG	Restituisce il valore calcolato come numero 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 dei contatori 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 sono limitati a un valore pari a 100.
PDH_FMT_1000	Moltiplicare il valore finale per 1.000.

[in] rawValue1

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

[in] rawValue2

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 di 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 più vecchio dei due valori non elaborati.

[out] fmtValue

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. Di seguito sono riportati i valori possibili.

Codice restituito	Descrizione
PDH_INVALID_ARGUMENT	Un argomento non è corretto o non è formattato correttamente.
PDH_INVALID_HANDLE	L'handle del contatore non è valido.

Commenti

Per recuperare il valore corrente del contatore non elaborato dalla query, chiamare la funzione PdhGetRawCounterValue .

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

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor

Condividi tramite