Funzione GetProcessorSystemCycleTime (sysinfoapi.h)

  • Articolo

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

Vedere anche

Gruppi di processori