Compartilhar via


Função GetProcessorSystemCycleTime (sysinfoapi.h)

Recupera o tempo de ciclo que cada processador no grupo de processadores especificado gastou executando DPCs (chamadas de procedimento adiado) e ISRs (rotinas de serviço de interrupção) desde que o processador se tornou ativo.

Sintaxe

BOOL GetProcessorSystemCycleTime(
  [in]      USHORT                                   Group,
  [out]     PSYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION Buffer,
  [in, out] PDWORD                                   ReturnedLength
);

Parâmetros

[in] Group

O número do grupo de processadores para o qual recuperar o tempo do ciclo.

[out] Buffer

Um ponteiro para um buffer para receber uma estrutura SYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION para cada processador no grupo. Na saída, o membro DWORD64 CycleTime dessa estrutura é definido como o tempo de ciclo de um processador.

[in, out] ReturnedLength

O tamanho do buffer, em bytes. Quando a função retorna, esse parâmetro contém o número de bytes gravados em Buffer. Se o buffer for muito pequeno para os dados, a função falhará com ERROR_INSUFFICIENT_BUFFER e definirá o parâmetro ReturnedLength como o tamanho do buffer necessário.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, use GetLastError.

Se o valor de erro for ERROR_INSUFFICIENT_BUFFER, o parâmetro ReturnedLength conterá o tamanho do buffer necessário.

Comentários

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0601 ou posterior. 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 sysinfoapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Grupos de processadores