Funzione QueryIdleProcessorCycleTimeEx (realtimeapiset.h)

Recupera il tempo di ciclo accumulato per il thread inattiva in ogni processore logico nel gruppo di processori specificato.

Sintassi

BOOL QueryIdleProcessorCycleTimeEx(
  [in]      USHORT   Group,
  [in, out] PULONG   BufferLength,
  [out]     PULONG64 ProcessorIdleCycleTime
);

Parametri

[in] Group

Numero del gruppo di processori per il quale recuperare il tempo del ciclo.

[in, out] BufferLength

In input specifica le dimensioni del buffer ProcessorIdleCycleTime in byte. Questo buffer dovrebbe essere 8 volte il numero di processori nel gruppo.

Nell'output specifica il numero di elementi scritti nel buffer. Se le dimensioni del buffer non sono sufficienti, la funzione ha esito negativo e questo parametro riceve la lunghezza richiesta del buffer.

[out] ProcessorIdleCycleTime

Numero di cicli di clock della CPU usati da ogni thread inattivo. Se questo parametro è NULL, la funzione aggiorna il parametro BufferLength con la lunghezza richiesta.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, usare GetLastError.

Osservazioni

Per compilare un'applicazione che usa questa funzione, impostare _WIN32_WINNT >= 0x0601. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Fabbisogno

Vedere anche

gruppi di processori

QueryIdleProcessorCycleTime