Compartilhar via


Função GetSystemTimes (processthreadsapi.h)

Recupera informações de tempo do sistema em "tiques" (ou intervalos de 100 nanossegundos).

Sintaxe

BOOL GetSystemTimes(
  [out, optional] PFILETIME lpIdleTime,
  [out, optional] PFILETIME lpKernelTime,
  [out, optional] PFILETIME lpUserTime
);

Parâmetros

[out, optional] lpIdleTime

Um ponteiro para uma estrutura FILETIME que recebe a quantidade de tempo em "tiques" que o sistema ficou ocioso.

[out, optional] lpKernelTime

Um ponteiro para uma estrutura FILETIME que recebe a quantidade de tempo em "tiques" que o sistema gastou executando no modo Kernel (incluindo todos os threads em todos os processos, em todos os processadores). Esse valor de tempo também inclui a quantidade de tempo que o sistema ficou ocioso.

[out, optional] lpUserTime

Um ponteiro para uma estrutura FILETIME que recebe a quantidade de tempo em "tiques" que o sistema gastou executando no modo de usuário (incluindo todos os threads em todos os processos, em todos os processadores).

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

Em um sistema multiprocessador (com 64 processadores ou menos), o valor retornado é a soma dos tempos designados em "tiques" em todos os processadores.

Observação

Em sistemas com mais de 64 processadores, o valor retornado é a soma dos tempos designados para o grupo de processadores primário ao qual o thread de chamada pertence (consulte Grupos de Processadores).

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0501 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Requisitos

Requisito Valor
Cliente mínimo suportado Windows Vista, Windows XP com SP1 [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho processthreadsapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
de DLL Kernel32.dll