Função QueryIdleProcessorCycleTimeEx (realtimeapiset.h)

  • Artigo

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

Confira também

Grupos de processadores

QueryIdleProcessorCycleTime