Funzione PdhGetCounterTimeBase (pdh.h)
Restituisce la base temporale del contatore specificato.
Sintassi
PDH_FUNCTION PdhGetCounterTimeBase(
[in] PDH_HCOUNTER hCounter,
[out] LONGLONG *pTimeBase
);
Parametri
[in] hCounter
Handle per il contatore. La funzione PdhAddCounter restituisce questo handle.
[out] pTimeBase
Base temporale che specifica il numero di valori delle prestazioni di un campione di contatori al secondo.
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 |
|---|---|
|
Il contatore specificato non utilizza una base temporale. |
|
L'handle del contatore non è valido. |
Commenti
Se si usa la funzione PdhFormatFromRawValue per calcolare un valore visualizzabile anziché chiamare la funzione PdhCalculateCounterFromRawValue , è necessario chiamare la funzione PdhGetCounterTimeBase per recuperare la base temporale.
Ogni contatore che restituisce dati sulle prestazioni basati sul tempo ha una base temporale definita per tale contatore. La base temporale di un contatore è il numero di volte in cui un contatore campia i dati al secondo.
Requisiti
| 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 |