Funzione PdhComputeCounterStatistics (pdh.h)

Articolo
03/05/2024

Calcola le statistiche per un contatore da una matrice di valori non elaborati.

Sintassi

PDH_FUNCTION PdhComputeCounterStatistics(
  [in]  PDH_HCOUNTER     hCounter,
  [in]  DWORD            dwFormat,
  [in]  DWORD            dwFirstEntry,
  [in]  DWORD            dwNumEntries,
  [in]  PPDH_RAW_COUNTER lpRawValueArray,
  [out] PPDH_STATISTICS  data
);

Parametri

[in] hCounter

Handle del contatore per cui si desidera calcolare le statistiche. La funzione PdhAddCounter restituisce questo handle.

[in] dwFormat

Determina il tipo di dati del valore formattato. 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 i fattori 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] dwFirstEntry

Indice in base zero del primo valore del contatore non elaborato da utilizzare per iniziare i calcoli. Il valore di indice deve puntare alla voce meno recente nel buffer. La funzione inizia da questa voce e analizza il buffer, esegue il wrapping dell'ultima voce all'inizio del buffer e fino alla voce dwFirstEntry-1 , che si presuppone che sia i dati più recenti o più recenti.

[in] dwNumEntries

Numero di valori dei contatori non elaborati nel buffer lpRawValueArray .

[in] lpRawValueArray

Matrice di strutture PDH_RAW_COUNTER che contengono voci dwNumEntries .

[out] data

Struttura PDH_STATISTICS che riceve le statistiche del contatore.

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.

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_RAW_COUNTER

PDH_STATISTICS

PdhCalculateCounterFromRawValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor

Condividi tramite