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
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 de tamanho.
Valor de retorno
Se a função for bem-sucedida, o valor retornado não será zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Observações
Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou posterior.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2008 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | realtimeapiset.h (inclua Windows.h no Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| biblioteca | Mincore.lib |
| de DLL |
Kernel32.dll |