Visualizzazione dei dati sulle prestazioni
La maggior parte dei contatori richiede due valori di esempio per calcolare un valore visualizzabile. La formula per ogni contatore determina se il contatore richiede due campioni. Per un elenco dei contatori e delle relative formule, vedere la sezione Tipi di contatori di Windows Server 2003 Deployment Kit.
Raccolta di dati sulle prestazioni mostra come recuperare i dati di esempio. Dopo aver creato gli esempi, in genere si chiama PdhGetFormattedCounterValue per calcolare un valore visualizzabile.
Se è necessario aumentare o ridurre il valore del contatore per visualizzare il valore, chiamare la funzione PdhSetCounterScaleFactor prima di chiamare PdhGetFormattedCounterValue. I valori dei contatori possono essere ridimensionati con una potenza di dieci da un fattore compreso tra -7 e 7.
Se il percorso del contatore contiene un carattere jolly per il nome dell'istanza, chiamare PdhGetFormattedCounterArray per recuperare una matrice di valori dei contatori formattati per ogni istanza raccolta.
È anche possibile usare le funzioni PdhCalculateCounterFromRawValue e PdhFormatFromRawValue per calcolare un valore visualizzabile. Per usare queste funzioni, è necessario recuperare l'esempio raccolto dopo ogni chiamata PdhCollectQueryData e archiviare manualmente l'esempio. Per recuperare l'esempio, chiamare la funzione PdhGetRawCounterValue o PdhGetRawCounterArray . Per i valori dei contatori basati sul tempo, chiamare PdhGetCounterTimeBase prima di PdhFormatFromRawValue per recuperare la base temporale del contatore.
Se si eseguono calcoli usando i dati non elaborati, controllare sempre il membro CStatus della struttura PDH_RAW_COUNTER prima di usare l'esempio. L'esempio non è valido se il valore di CStatus non è PDH_CSTATUS_NEW_DATA o PDH_CSTATUS_VALID_DATA.
Visualizzazione delle statistiche per un contatore
Per calcolare i valori minimo, massimo e medio di un contatore, chiamare la funzione PdhComputeCounterStatistics . Quando si raccolgono campioni, archiviare le strutture PDH_RAW_COUNTER in una matrice passata a PdhComputeCounterStatistics. La funzione restituisce i valori statistici in una struttura PDH_STATISTICS .
È anche possibile usare questa funzione per comprimere un file di log. Ad esempio, leggere dieci record da un file di log, chiamare PdhComputeCounterStatistics per calcolare il valore medio e quindi scrivere il valore medio in un file di log di output.