Função QueryIdleProcessorCycleTimeEx (realtimeapiset.h)

Artigo
11/08/2024

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

Observações

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
de cliente com suporte mínimo	Windows 7 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	realtimeapiset.h (inclua Windows.h)
biblioteca	Mincore.lib
de DLL	Kernel32.dll

Consulte também

grupos de processadores

QueryIdleProcessorCycleTime

Compartilhar via