Função QueryIdleProcessorCycleTime (realtimeapiset.h)

Recupera o tempo de ciclo para o thread ocioso de cada processador no sistema.

Em um sistema com mais de 64 processadores, essa função recupera o tempo de ciclo do thread ocioso de cada processador no grupo de processadores ao qual o thread de chamada é atribuído. Use a função QueryIdleProcessorCycleTimeEx para recuperar o tempo de ciclo do thread ocioso em cada processador lógico para um grupo de processadores específico.

Sintaxe

BOOL QueryIdleProcessorCycleTime(
  [in, out] PULONG   BufferLength,
  [out]     PULONG64 ProcessorIdleCycleTime
);

Parâmetros

[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. Esse buffer deve ser 8 vezes o número de processadores no sistema em tamanho.

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, chame GetLastError.

Comentários

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou posterior.

Requisitos

Confira também

Grupos de processadores

QueryIdleProcessorCycleTimeEx

QueryProcessCycleTime

QueryThreadCycleTime