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 |