Funzione GetProcessorSystemCycleTime (sysinfoapi.h)
Recupera il tempo di ciclo per ogni processore nel gruppo di processori specificato trascorso l'esecuzione di chiamate di routine posticipate (DPCS) e interruzioni delle routine di servizio (ISR) dal momento che il processore è diventato attivo.
Sintassi
BOOL GetProcessorSystemCycleTime(
[in] USHORT Group,
[out] PSYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION Buffer,
[in, out] PDWORD ReturnedLength
);
Parametri
[in] Group
Numero del gruppo di processori per cui recuperare il tempo del ciclo.
[out] Buffer
Puntatore a un buffer per ricevere una struttura SYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION per ogni processore del gruppo. In output, il membro CycleTime di questa struttura DWORD64 è impostato sul tempo di ciclo per un processore.
[in, out] ReturnedLength
Dimensioni del buffer, in byte. Quando la funzione restituisce, questo parametro contiene il numero di byte scritti in Buffer. Se il buffer è troppo piccolo per i dati, la funzione ha esito negativo con ERROR_INSUFFICIENT_BUFFER e imposta il parametro ReturnedLength sulla dimensione del buffer necessaria.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, usare GetLastError.
Se il valore di errore è ERROR_INSUFFICIENT_BUFFER, il parametro ReturnedLength contiene le dimensioni del buffer necessarie.
Commenti
Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0601 o versioni successive. Per altre informazioni, vedere Uso delle intestazioni di Windows.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | sysinfoapi.h (includere Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |