Função QueryIdleProcessorCycleTimeEx (realtimeapiset.h)
Recupera o tempo de ciclo acumulado para o thread ocioso em cada processador lógico no grupo de processadores especificado.
Sintaxe
BOOL QueryIdleProcessorCycleTimeEx(
[in] USHORT Group,
[in, out] PULONG BufferLength,
[out] PULONG64 ProcessorIdleCycleTime
);
Parâmetros
[in] Group
O número do grupo de processadores para o qual recuperar o tempo do ciclo.
[in, out] BufferLength
Na entrada, especifica o tamanho do buffer ProcessorIdleCycleTime , em bytes. Espera-se que esse buffer seja 8 vezes o número de processadores no grupo.
Na saída, especifica o número de elementos gravados no buffer. Se o tamanho do buffer não for suficiente, a função falhará e esse parâmetro receberá o comprimento necessário do buffer.
[out] ProcessorIdleCycleTime
O número de ciclos de relógio de CPU usados por cada thread ocioso. Se esse parâmetro for NULL, a função atualizará o parâmetro BufferLength com o comprimento necessário.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, use GetLastError.
Comentários
Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT >= 0x0601. Para obter mais informações, consulte Usando os cabeçalhos do Windows.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | realtimeapiset.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |